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FOREWORD 


互联 网 的 发 展 带 来 了 新 的 科技 革命 ，Web 2.0 的 概念 更 是 将 网 络 
技术 和 应 用 推 向 了 新 的 高 潮 。 在 这 个 技术 日 新 月 异 发 展 的 年 代 , 各 种 
框架 、 各 种 概念 、 各 种 思想 呈现 出 了 百花 齐 放 局 面 ， 虽 然 无 比 繁荣 ， 
却 让 人 十 分 眼花 综 乱 。 选 择 一 种 最 适用 的 Web 框架 ， 可 以 给 开发 时 
间 、 开 发 成 本 、 开 发 质量 带 来 巨大 的 影响 。 

当今 世界 是 一 个 创造 奇迹 的 时 代 。J2EE 创造 了 一 个 奇迹 ， 使 得 
开发 企业 级 的 Web 应 用 变 得 快速 、 可 靠 、 经 济 ， 从 而 成 为 近年 来 的 
主流 Web 开发 框架 。RoR 的 诞生 创造 了 另 一 个 奇迹 ， 它 的 开发 效率 
是 J2EE 的 5 倍 以 上 , 而 且 相 比 PHP 技术 , 它 有 着 更 好 的 代码 组 织 结 
构 ， 更 容易 写 出 高 质量 的 代码 。 

Grails 是 继 RoR 之 后 的 又 一 个 奇迹 : 它 不 但 具备 J2EE 和 RoR 的 
诸多 优点 ,还 解决 了 RoR 不 能 有 效 适用 于 广大 Java 用 户 的 一 大 难题 。 
目前 ，Grails 已 得 到 了 业内 广泛 地 认可 。 在 2008 年 11 月 11 日 , 以 
Spring 框架 而 闻名 于 天 下 的 SpringSource 宣布 收购 主导 Grails 开发 的 
G2one 公司 ， 并 承诺 在 收购 之 后 ， 会 投入 更 大 的 力量 去 改进 Grails 
并 且 对 Grails 的 全 球 用 户 提供 商业 支持 。 正 如 著名 的 ququjoy 的 评论 
所 述 :“SpringSource 将 G2One 收购 之 后 ， 以 Spring 为 底层 框架 的 
Grails 必 将 迎 来 自己 的 春天 ”。 对 于 还 在 观望 的 用 户 , 还 犹 静 什 么 呢 ? 
赶快 加 入 到 Grails 的 使 用 者 队伍 中 吧 , 充分 享受 Grails 带 来 的 实用 与 
便捷 。 

目前 , 市 面 上 关于 J2EE 的 书籍 数不胜数 。 关于 RoR 的 书籍 也 至 
少 有 数 十 本 。 然 而 ， 也 许 很 快 将 引领 潮流 的 Grails 实在 太 新 了 , 它 的 
资料 主要 还 在 Grails 官方 网 站 上 能 获得 。 关于 Grails 的 中 文书 籍 仅 有 
两 本 外 版 图 书 ， 并 且 介 绍 的 是 低 版 本 的 Grails。 这 对 于 广大 爱好 Web 
开发 、 并 渴望 学 习 Grails 这 门 新 技术 的 读者 来 说 ， 不 能 不 说 是 一 个 
遗憾 。 

可 喜 的 是 , 这 本 书 问 世 了 , 该 书 的 作者 们 自己 使 用 Grails 开发 了 
许多 成 功 的 应 用 。 为 了 撰写 该 书 , 他 们 亲自 编写 了 一 个 典型 的 网 上 购 
物 车 的 Web 应 用 实例 。 通 过 Web 实例 制作 的 示范 和 讲解 ， 由 浅 入 深 
地 分 析 了 Grails 的 神奇 ， 实 践 性 非常 强 。 同 时 ， 本 书 也 对 Grails 的 源 
代码 、 基 于 MVC 的 Web 开发 原理 进行 了 深入 的 分 析 ， 亦 不 失 理论 
深度 。 该 书 的 面市 相信 会 为 Web 开发 爱好 者 带 来 一 个 小 的 惊喜 。 

该 书 优美 地 结合 了 理论 与 实践 ,不失为 一 本 优秀 的 教科 书 和 程序 
员 与 项 目 经 理 的 参考 手册 。 值 得 一 读 。 

孙 伟 
北京 航空 航天 大 学 软件 学 院 院 长 
2009 年 4 月 5 日 
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目前 , 虽然 J2EE 仍然 是 企业 级 Web 开发 的 主流 ,但 越 来 越 多 的 
企业 和 个 人 在 开发 新 项 目 时 更 倾向 于 尝试 使 用 RoR， 因 为 用 RoR 开 
发 Web 应 用 ， 可 以 更 快捷 、 更 简单 。 仿 佛 在 一 夜 之 间 ，RoR 成 为 了 
Web 框架 领域 内 最 耀眼 的 明星 ，RoR 的 一 些 理念 ， 如 约定 优 于 配置 ， 
已 经 成 为 了 新 框架 设计 的 金 科 玉 律 。 

然而 ，RoR 对 于 世界 上 数量 最 大 的 Java 用 户 来 说 ， 并 不 足够 友 
好 。 第 一 ，Ruby 语法 与 Java 类 语言 有 较 大 区 别 ， 需 要 克服 较 大 的 
障碍 才能 掌握 。 第 二 ， 历 史 遗留 项 目 问题 ，Java 语言 的 广泛 流行 使 
得 大 量 既 有 项 目 是 用 Java 开发 的 ， 而 且 这 些 项 目 还 需要 被 继续 支持 
和 扩展 ， 扩 展 历史 遗留 项 目的 任务 ，RoR 显得 无 能 为 力 。 第 三 ， 人 性 
能 问题 ，Ruby 语言 相对 于 Java， 其 执行 性 能 较 差 。 上 面 这 些 因素 ， 
都 会 制约 RoR 在 实际 项 目 中 的 使 用 。 正 是 在 这 一 背景 下 ，Grails 诞 
生 了 。 

Grails 的 全 称 为 Groovy on Rails, 是 一 种 基于 Groovy 语言 的 Rails 
类 框架 。 它 继承 了 RoR 的 绝 大 多 数 优 点 ， 几 乎 和 RoR 一 样 简单 。 而 
对 于 RoR 的 不 足 , 它 有 着 明显 的 优势 ,第 一 , Groovy 语言 运行 于 JVM， 
可 以 透明 地 执行 Java 程序 。Java 程序 员 可 以 迅速 地 掌握 Groovy， 同 
时 对 基于 Java 的 历史 遗留 项 目 ， 可 以 得 到 非常 好 的 支持 。 第 二 ， 
Groovy 语言 的 执行 性 能 虽然 不 及 Java， 仍 然 比 Ruby 有 较 大 的 优势 。 
另 一 方面 ，Grails 虽然 名 为 Groovy on Rails， 但 实际 上 Grails 的 主要 
开发 语言 是 Java，Grails 框架 有 的 绝 大 多 数 代码 是 用 Java 编写 的 , 因 
而 ，Grails 的 性 能 就 更 可 以 得 到 保障 。 

Grails 技术 凭借 它 卓越 的 设计 ， 给 用 户 提供 了 一 种 高 效 、 简 单 易 
用 、 一 栈 式 Web 开发 的 框架 。 利 用 Grails 技术 ， 可 以 以 极 低 的 学 习 
代价 ， 换 来 很 高 的 开发 效率 。 使 用 Grails 开发 Web 应 用 ， 需 要 使 用 
的 编程 语言 是 Groovy 语言 。Groovy 是 运行 于 JVM 之 上 的 程序 设计 
语言 ， 近 些 年 发 展 迅猛。 对 于 Java 用 户 ， 要 想 掌 握 Groovy， 是 非常 
容易 的 ， 学 习 曲 线 也 非常 平缓 ， 甚 至 不 需要 学 习 ， 仅 凭借 Java 的 基 
本 功 , 就 可 以 把 Grails 驾驭 得 非常 好 。 因 此 ， 极 力 推荐 正在 使 用 Java 
开发 Web 应 用 的 公司 、 学 生 、 个 人 用 户 学 习 并 使 用 Grails。 对 于 没有 
掌握 Java 技术 ， 但 很 想 学 习 Web 开发 技术 的 用 户 ， 那 不 妨 就 直接 从 
Grails 开始 吧 ，Grails 非常 容易 掌握 。 使 用 Grails， 开 发 人 员 就 可 以 
更 多 地 把 精力 花 在 业务 上 ， 而 不 是 技术 细节 上 。 


一 、 阅 读本 书 需要 的 预备 知识 


现代 的 Web 应 用 通常 会 涉及 到 页 面 设计 、 数 据 存储 等 多 个 方面 。Grails 将 这 方方面面 
的 问题 都 考虑 了 进来 ， 因 而 说 Grails 是 一 个 一 栈 式 的 框架 。 本 书 预 期 的 读者 ， 应 预备 以 下 
几 方 面 的 基础 知识 。 

1. HTML 的 基础 知识 。 是 的 ， 无 论 如 何 ，HTML 都 是 Web 技术 的 基础 ， 只 有 具备 一 
定 的 HTML 基础 ， 才 能 设计 并 输出 Web 页 面 的 基本 元 素 。 同 时 ， 应 该 对 表单 的 提交 
(GET/POST) 有 所 了 解 。 当 然 ， 这 部 分 内 容 非 常 容易 掌握 ， 通 过 百度 Google， 可 以 轻松 地 
找到 许多 有 用 的 教程 。 

2. 数据 库 的 基础 知识 。Grails 对 数据 库 的 操作 进行 了 封装 和 简化 ， 但 开发 人 员 仍然 有 
必要 掌握 一 定 的 数据 库 知识 ， 对 数据 库 表 、 主 键 、 外 键 、 索 引 ， 有 基本 的 了 解 。 能 够 读 写 
简单 的 SQL 语句 。 只 有 这 样 ， 才 能 真切 地 体会 到 Grails 与 生 俱 来 的 快捷 与 便利 ， 而 且 遇 到 
问题 才 不 会 茫然 。 

3. Java 语言 或 Groovy 语言 ， 或 者 其 他 类 似 的 面向 对 象 程序 语言 。 使 用 Grails 进行 开 
发 ， 需 要 使 用 Groovy 语言 。 掌 握 Java， 就 意味 着 在 相当 程度 上 掌握 了 Groovy。 它 们 二 者 
间 比 较 重 要 的 差异 ， 本 书 中 会 进行 必要 的 介绍 。 当 然 ， 对 于 不 了 解 Java 但 至 少 掌握 了 一 种 
编程 语言 的 读者 ， 学 习 Groovy 也 不 会 有 任何 困难 ， 毕 竟 Groovy 的 设计 思想 就 是 设计 一 种 
比 Java 更 简单 易 用 的 编程 语言 。 

4. Hibernate 基础 知识 〈 非 必需 )。 本 书 会 对 Grails 的 部 分 实现 原理 进行 深入 和 分 析 ， 
会 涉及 到 许多 Hibernate 中 的 概念 。 读 者 如 果 只 是 希望 用 Grails 开发 自己 的 Web 应 用 ， 则 
无 需要 求 这 一 点 。 

二 、 关 于 本 书 的 内 容 说 明 


本 书 的 内 容 包括 四 大 部 分 。 从 第 一 部 分 到 第 四 部 分 ， 按 知识 的 难度 和 深度 ， 存 在 一 定 
的 递 进 关系 。 但 各 部 分 也 相对 独立 。 

第 一 部 分 是 入 门 篇 ， 介 绍 了 Grails 必 备 的 基础 知识 ， 包 括 : 环境 配置 、Groovy 语言 
础 、HelloWorld 程序 开发 实例 ， 以 及 一 些 基本 概念 。 对 于 熟悉 Java 编程 的 读者 ， 可 以 快速 
浏览 本 部 分 。 

第 二 部 分 共 7 章 ， 以 从 代 增 量 的 方式 ， 完 整地 设计 并 开发 了 一 个 Web 应 用 一 一 网 络 购 
物 车 。 该 部 分 内 容 从 最 简单 的 环境 准备 开始 ， 接 下 来 包括 数据 创建 、 数 据 查 询 、 数 据 维护 
与 管理 、 系 统 后 台 管理 、 系 统 测试 、 系 统 部 署 等 。 该 部 分 是 一 个 逐步 完善 的 过 程 ， 每 开始 
新 的 一 章 ， 就 是 增加 了 一 些 新 的 功能 和 知识 点 。 

学 习 完 前 两 部 分 ， 可 以 掌握 Grails 主要 的 基础 知识 ， 并 能 开发 一 些 简单 的 Web 应 用 。 
这 可 以 称 得 上 是 Grails 开发 的 初级 用 户 了 。 

第 三 部 分 共 6 章 ， 对 Grails 的 关键 问题 进行 了 比较 深入 的 讨论 ， 对 相关 的 原理 进行 了 
介绍 。 该 部 分 内 容 包 括 Grails 的 MVC 原理 、GSP 输出 、Web Service 实现 、Grails 插件 使 
用 等 内 容 。 本 部 分 的 内 容 有 一 定 难度 和 深度 ,但 这 些 知 识 也 是 Web 开发 的 基本 要 素 ， 要 开 


发 真正 实用 的 Web 应 用 ， 掌 握 这 些 知识 是 必要 的 。 

掌握 了 前 三 部 分 内 容 的 读者 ， 可 以 称 得 上 是 中 级 用 户 了 ， 能 够 比较 熟练 地 使 用 Grails 
开发 Web 应 用 。 

第 四 部 分 是 最 后 5 章 ， 其 内 容 包括 : 介绍 Groovy 的 高 级 特性 、 分 析 Grails 的 源码 、 讲 
解 Grails 的 插件 开发 、 阐 述 Grails 的 新 特性 等 。 该 部 分 内 容 难 度 和 深度 都 较 大 , 是 对 Grails 
的 一 些 原理 进行 深入 分 析 。 掌 握 该 部 分 内 容 ， 有 助 于 帮助 读者 体会 出 Grails 之 所 以 如 此 神 
奇 的 奥妙 所 在 ， 在 实践 中 能 够 通过 灵活 运用 Grails， 并 可 能 修改 源码 ， 进 行 更 丰富 的 二 次 
开发 。 

在 实例 分 析 和 原理 解析 上 ， 本 书 两 者 并 重 ， 它 们 分 别 占 了 约 一 半 的 篇 幅 。 但 两 者 并 不 
是 截然 分 离 的 ， 有 的 时 候 两 者 是 有 机 地 结合 在 一 起 。 读 者 通 本 书 实例 的 学 习 实践 ， 可 以 依 
葫芦 画 球 地 开发 自己 的 Web 应 用 ; 通过 品味 Grails 的 原理 ， 将 能 开发 出 更 多 、 更 复杂 的 
Web 应 用 。 读 完 这 本 书 ， 读 者 不 仅仅 能 开发 一 个 网 上 购物 车 ， 同 样 能 开发 自己 的 工作 流 、 
表单 系统 、 等 等 。 

由 于 Grails 的 知识 很 新 ， 可 参考 的 文献 非常 少 ， 本 书 的 知识 大 部 分 是 作者 从 Grails 的 
官方 资料 中 获得 的 。 本 书 是 作者 通过 阅读 和 分 析 Grails 的 源码 ， 亲 自 开发 Web 应 用 ， 编 写 
了 较 多 的 实际 代码 ， 然 后 再 总 结 自己 从 事 Web 开发 的 一 些 经 验 而 完成 的 。 本 书 原创 内 容 较 
多 ， 因 而 玻 漏 之 处 可 能 不 少 ， 诚 姑 地 请 读者 批评 指正 。 


三 、 代 码 的 阅读 说 明 


本 书 的 代码 可 从 网 络 下 载 , 网 址 为 www.tup.tsinghua.edu.cn, 包括 了 网 络 购物 车 的 完整 
代码 。 

在 本 书 中 ， 因 为 购物 车 的 开发 是 增 量 进行 的 ， 所 以 随 着 每 一 章 的 代码 逐步 添加 ， 最 后 
才 形 成 了 完整 的 应 用 代码 。 但 读者 在 阅读 过 程 中 ， 阅 读 并 实践 到 某 些 章节 时 ， 因 为 还 不 涉 
及 到 后 面 章 节 的 内 容 ， 所 以 将 会 发 现 自己 按 书 上 步骤 介绍 而 写 出 来 的 代码 跟 我 们 提供 代码 
的 内 容 并 不 一 致 。 

但 我 们 不 打算 把 每 一 章 的 代码 都 单独 放 在 一 个 文件 夹 里 ， 写 成 一 个 独立 的 应 用 。 一 方 
面 ， 这 样 会 破坏 该 应 用 的 完整 性 ， 另 一 方面 ， 也 是 更 重要 的 ， 读 者 在 阅读 每 一 章 时 ， 可 能 
会 不 假 思索 地 把 我 们 的 代码 复制 到 开发 环境 里 ， 顺 利 地 让 程序 运行 起 来 ， 自 己 却 可 能 并 不 
明白 代码 说 的 是 什么 。 

读者 在 阅读 并 实践 本 书 的 应 用 实例 时 ， 我 们 鼓励 读者 按 书 上 描述 的 步骤 ， 尽 量 自己 亲 
自 输入 相关 的 代码 ， 并 运行 程序 分 析 结 果 。 如 果 有 些 例子 的 代码 的 确 非常 多 ， 可 以 从 我 们 
提供 的 代码 里 摘录 部 分 核心 内 容 。 

另外 ， 在 分 析 实例 时 ， 有 些 知识 点 的 代码 也 比较 长 ， 我 们 在 书 里 也 没有 全 部 把 代码 列 
出 来 ， 读 者 可 以 参阅 网 络 文件 里 的 相关 内 容 。 


四 、 写 作 小 札 


在 2008 年 4 月 初时 ， 我 们 刚 使 用 Grails 开发 了 一 个 成 功 的 商业 应 用 。 在 开发 该 应 用 
的 过 程 中 ， 我 们 深刻 感受 到 Grails 中 文 资料 在 国内 的 匮乏 ， 而 且 原创 的 Grails 中 文书 籍 在 


国内 还 没有 。 另 外 ， 市 面 关 于 Grails 的 书籍 中 ， 基 本 上 都 是 以 Grails 0.3 为 基础 来 介绍 的 
但 当时 主流 应 用 的 是 Grails 1.03, 两 者 的 差距 较 大 。 这 给 广大 Web 爱好 者 学 习 和 应 用 Grails 
带 来 了 困难 。 于 是 ， 我 们 就 萌发 了 写作 此 书 的 想法 。 

2008 年 五 一 后 ， 该 写作 计划 开始 启动 ， 并 且 该 计划 得 到 了 清华 大 学 出 版 社 和 北航 软件 
学 院 的 大 力 支持 。 

我 们 原 计划 用 大 约 半年 时 间 完 成 该 书 的 写作 ， 但 事实 上 花 了 近 一 年 时 间 才 完稿 。 实 际 
写作 过 程 中 ， 开 发 一 个 完整 的 Web 应 用 实例 并 不 是 难事 。 但 在 分 析 Grails 的 原理 时 ， 要 把 
Grails 之 所 以 神奇 的 本 质 阐述 清楚 (例如 Grails 如 何 通过 Hibernate 进行 数据 库 操作 、 如 何 
通过 Spring 引入 外 部 的 组 件 、 等 等 )， 则 并 不 容易 ， 主 要 是 这 方面 的 参考 资料 非常 少 ， 作 
者 不 得 不 花 大 量 的 功夫 来 仔细 研读 并 分 析 Grails 的 源 代码 ， 然 后 用 通俗 的 语言 ， 并 设计 一 
些 例 程 进行 解释 。 

本 书 的 大 部 分 内 容 是 在 2008 年 完成 的 ， 这 其 中 经 历 国 人 大 悲 的 5.12 地 震 和 大 喜 的 北 
京 奥运 会 ， 因 此 ， 我 们 的 写作 心情 也 受到 巨大 的 影响 ， 前 半年 时 间 是 在 心情 很 不 平静 的 情 
况 下 完成 写作 的 。 整 个 暑假 ， 我 们 每 天 都 在 坚持 写作 ， 当 然 ， 期 间 有 伴随 着 边 看 奥运 会 边 
写作 的 一 段 快 乐 日 子 。 在 此 期 间 ， 我 们 也 承接 了 一 些 用 Grails 开发 的 Web 应 用 小 项 目 ， 当 
然 ， 那 时 我 们 使 用 Grails 开发 的 速度 已 非常 快 ， 效 益 比 率 也 非常 可 观 。 开 发 这 些 应 用 ， 对 
于 我 们 进一步 理解 Grails， 从 而 更 好 地 写作 该 书 提供 了 许多 有 意义 的 启发 。 

我 们 写作 的 基础 曾 是 Grails 1.03, 但 Grail 的 发 展 很 快 , 寒假 前 夕 , 我 们 的 书稿 快 完 时 ， 
Grails 1.04 正式 版 出 来 了 ， 我 们 不 得 不 把 整 本 书 的 相关 内 容 都 换 成 1.04 版 的 内 容 。 当 时 ， 
1.1 版 的 测试 版 也 有 了 ,于 是 我 们 还 特别 地 介绍 了 部 分 新 版 本 的 新 特性 。 但 很 遗憾 ， 刚 完稿 
没 多 久 ，1.1 的 正式 版 又 出 来 了 。 我 们 深刻 理解 ， 计 算 机 和 领域， 技术 的 更 新 速度 永远 都 比 知 
识 传播 得 要 快 ， 因 此 我 们 知道 ， 我 们 难以 保证 今天 出 的 书 里 面 的 内 容 一 定 反 映 今天 最 新 的 
事情 ， 虽 然 我 们 有 时 可 以 预测 今天 或 明天 将 要 发 生 的 事情 。 该 书目 前 以 Grails 1.04 为 基础 
进行 介绍 ， 这 对 于 读者 学 习 和 使 用 1.1 版 而 言 ， 应 该 说 没有 影响 。 不 过 我 们 希望 ， 每 隔 一 
段 时 间 后 ， 能 不 断 有 新 结合 Grails 新 版 本 、 反 映 Grails 新 特性 的 书籍 出 现 。 下 一 个 作者 ， 
也 许 就 是 你 一 一 今天 的 读者 。 

该 书写 完 后 ， 本 书 的 作者 之 一 , 梁 士 兴 也 顺利 硕士 毕业 了 。 在 进行 该 书 的 写作 过 程 中 ， 
他 还 完成 了 自己 的 学 位 论文 写作 、 论 文 答辩 、 就 业 等 事情 ， 并 且 ， 写 作 这 本 书 也 有 力 地 促 
进 了 他 在 学 业 和 就 业 上 的 进步 。 最 终 ， 他 以 优良 的 毕业 成 绩 通过 答辩 ， 并 得 到 了 自己 满意 
的 工作 一 一 获得 了 IBM 的 offer。 于 是 ， 他 得 到 一 个 感悟 ， 读 一 本 好 书 、 学 习 一 门 技术 、 
开发 一 个 项 目 、 撰 写 一 本 书 和 文章 ， 其 收获 可 能 是 自己 也 无 法 预知 的 一 个 惊喜 。 


五 、 致 谢 
在 本 书 近 一 年 的 写作 过 程 ， 得 到 了 广大 老师 、 朋 友 的 热心 支持 。 


感谢 北京 航空 航天 大 学 软件 学 院 的 领导 和 老师 对 该 书 撰写 工作 的 支持 ， 并 提供 了 良好 
的 写作 条 件 ， 该 项 目 得 到 了 北京 市 教育 委员 会 第 二 类 特色 专业 建设 项 目 支持 。 
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导论 


s] 。 


1.1 RoR 的 革命 与 Web 开发 的 新 时 代 


随 着 互联 网 的 普及 和 发 展 ， 绝 大 多 数 计算 机 应 用 被 设计 为 基于 Web 技术 的 Web 应 用 。 
Web 应 用 有 着 发 布 快捷 、 使 用 简便 、 对 客户 端 要 求 低 等 优势 。 通 过 Web 技术 ， 可 以 让 企业 
更 容易 发 布 服务 , 也 可 以 让 用 户 更 容易 享受 信息 时 代 的 便捷 。Web 的 优势 导致 了 Web 开发 
的 需求 呈现 出 爆炸 式 的 增长 ， 进 一 步 则 对 Web 开发 技术 提出 了 更 高 的 要 求 。 

RoR (Ruby on Rails) 的 诞生 就 创造 了 一 个 这 样 的 奇迹 ， 它 在 短 短 的 几 年 间 ， 在 无 数 
如 JSP、PHP 等 元 老 级 的 Web 技术 面前 脱颖而出 ， 并 且 给 了 整个 JPEE 世界 以 极 大 的 震撼 ! 
正如 RoR 所 标榜 的 , 它 的 开发 效率 是 J2EE 的 5 倍 以 上 .这样 巨 大 的 差异 不 可 能 不 引起 Java 
世界 的 反思 。 

首先 , 为 什么 Rails 这 样 成 功 的 开发 框架 会 诞生 于 Ruby 语言 , 而 且 在 其 出 现 之 后 , Java 
世界 并 没有 产生 能 与 之 抗衡 或 者 模仿 它 的 框架 呢 ? 其 次 ，Java 在 企业 级 开发 中 一 直 追 求 的 
重量 级 的 大 而 全 ， 真 的 是 用 户 的 最 想 要 吗 ? 

带 着 这 样 的 几 个 问题 ， 这 里 不 妨 简单 分 析 一 下 RoR 所 取得 的 成 功 。 

首先 RoR 的 优雅 与 快捷 ， 相 当 程度 上 源 于 动态 脚本 语言 Ruby 的 “元 编程 ”技术 。 

所 谓 动态 语言 ， 一 般 有 两 层 含义 : 动态 类 型 和 动态 结构 。RoR 的 基础 一 Ruby 语言， 
同时 符合 上 面 的 两 种 特性 。 支 持 动态 类 型 ， 指 只 在 运行 时 确定 Ruby 的 变量 类 型 信息 ; 支 
持 动 态 结构 ， 指 利用 “元 编程 ”技术 ， 在 程序 运行 时 ， 对 Ruby 类 的 属性 和 方法 进行 动态 
增 减 。“ 元 编程 ”的 技术 可 以 用 于 实现 更 灵活 的 Web 框架 ， 它 是 Java 等 静态 语言 所 不 具备 
的 特性 ， 因 而 很 遗憾 ，Java 不 可 能 实现 出 Rails 这 样 的 框架 。 

谈 概念 , 总 是 让 人 昏 昏 欲 睡 。 不 妨 看 看 例子 。 假 设 数据 库 的 Goods 表 包 含 name 和 title 
字段 ， 那 么 针对 这 两 个 字段 进行 联合 查询 的 代码 如 下 : 


def goodsList = Goods.findAllByNameAndTitle (name, title) 


传统 方法 (如 Java) 设计 框架 ， 想 实现 提供 类 似 findAllByNameAndTitle 这 样 的 方 
法 ， 是 不 现实 的 。 因 为 仅 name 和 title 就 会 有 “name and title” 和 “name or title” 两 种 条 
件 组 合 (考虑 到 name 和 title 前 后 位 置 蔡 换 ， 虽 然 罗 辑 相同 ， 但 对 应 的 函数 名 不 同 ， 所 以 
应 该 是 排列 )， 再 加 上 其 他 属性 , 产生 的 查询 和 排序 会 呈现 出 爆炸 式 的 增长 , 再 聪明 的 框架 
也 不 可 能 预先 准备 好 应 付 所 有 的 情况 。 通 常 需要 用 户 自己 去 实现 相关 的 查询 逻辑 ， 即 自己 


编程 实现 findAlIByNameAndTitle。 显 然 ， 利 用 Ruby 的 “元 编程 ”技术 动态 添加 方法 ， 在 
框架 级 别 实现 支持 这 样 的 动态 查询 ,无 疑 会 使 开发 变 得 简单 很 多 。 而 Java 这 样 的 静态 语言 
则 很 难 实现 这 样 的 功能 。 因 此 ， 可 以 这 样 理解 ，Rails 利用 了 Java 不 支持 的 动态 脚本 语言 
的 特性 ， 实 现 了 许多 更 有 利于 减轻 用 户 开 发 劳动 的 功能 ， 从 而 让 用 户 觉得 Rails 更 简单 快 
捷 。Rails 正 是 因为 这 样 而 取得 了 成 功 。 

RoR 的 设计 指导 思想 就 是 简化 开发 过 程 。 传 统 的 Java 开发 方式 , 其 设计 显得 过 于 学 术 
化 ， 而 忽略 了 用 户 的 感受 。 典 型 的 如 SSH (Stmuts + Spring + Hibernate》 的 开发 方式 ， 为 了 
追求 灵活 性 ， 系 统 的 各 层 都 可 以 蔡 换 成 其 他 的 框架 。 虽 然 灵 活 ， 但 对 简化 开发 带 来 的 好 处 
却 非常 有 限 。RoR 则 设计 得 非常 实用 ， 提 供 一 个 一 栈 式 的 解决 方案 ， 各 层 的 设计 都 只 有 一 
个 目标 ， 那 就 是 简单 ! 

虽然 RoR 比 J2EE 简单 , 但 RoR 同样 有 着 良好 的 组 织 结构 。PHP 也 是 十 分 简单 易 用 的 
Web 开发 技术 ， 与 PHP 相 比 ，Rails 最 大 的 优势 就 在 于 它 的 组 织 结构 更 加 清晰 。RoR 是 一 
个 MVC (Model-View-Control, 模型 -视图 -控制 器 ) 的 Web 框架 ， 它 在 工程 中 预先 定义 了 
若干 的 文件 夹 ， 分 别 用 于 存放 模型 -视图 -控制 器 ， 其 结构 非常 清晰 明了 。 这 体现 RoR 的 另 
一 个 理念 , 即 约定 优 于 配置 : 约定 不 同 的 文件 夹 中 存放 特定 类 型 的 文件 ， 而 无 需 进行 配置 。 


1.2” RoR 并 不 完美 


RoR 凭借 着 它 极 高 的 开发 效率 和 飞速 增长 的 用 户 数量 ， 毫 无 疑问 地 成 为 了 现 如 今 最 成 
功 的 Web 开发 技术 之 一 。 然 而 ，RoR 并 不 完美 ， 它 在 几 个 方面 还 存在 着 一 定 的 不 足 。 


1.2.1 Ruby 语言 方面 的 不 足 


虽然 Ruby 也 是 一 种 优秀 的 脚本 语言 ,但 它 存 在 着 执行 性 能 差 、.GC(Garbage Collection， 
垃圾 回收 ) 缺陷 等 不 足 。 

Ruby 的 语法 相对 Java 有 较 大 的 区 别 ， 对 Java 的 程序 员 而 言 ， 需 要 学 习 一 门 全 新 的 编 
程 语 言 ， 对 编程 习惯 有 较 大 的 冲击 。 

基于 Ruby 的 开源 项 目 较 少 ， 一 些 常见 的 开发 过 程 中 的 问题 ， 如 工作 流 、 全 文 检索 等 ， 
都 还 缺乏 成 熟 的 解决 方案 。 


1.2.2 ”对 历史 遗留 项 目的 支持 较为 困难 


Java 仍然 是 现在 最 流行 的 编程 语言 ， 在 企业 级 别 ， 有 大 量 基于 J2EE 技术 的 历史 遗留 
项 目 。 对 于 这 样 的 企业 ， 如 果 采 用 Ruby on Rails 开发 新 系统 ， 则 意味 着 难以 实现 对 历史 遗 
留 项 目的 支持 。 


1.3 ”Grails 的 诞生 解决 了 一 些 遗 憾 


Grails 的 全 称 为 Groovy on Rails， 是 一 种 基于 Groovy 语言 的 Rails 类 框架 。 它 继承 了 
RoR 的 绝 大 多 数 优点 : Grails 几乎 和 RoR 一 样 简单 ， 甚 至 在 某 些 方面 ， 比 RoR 更 简单 强大 
(如 数据 库 的 查询 访问 );，Grails 同样 也 遵循 约定 优 于 配置 的 指导 思想 。 除 此 之 外 ， 它 还 有 
如 下 几 个 不 同 于 RoR 的 特点 。 


43.1 Groovy 语言 


Groovy 是 与 Ruby 不 同 的 脚本 语言 ， 虽 然 Groovy 也 是 脚本 语言 ， 但 它 是 以 Java 字 节 
码 的 方式 运行 在 Java 虚拟 机 之 上 的 。 这 样 有 两 方面 好 处 : 一 方面 ， 可 以 有 较 好 的 性 能 ， 另 
一 方面 ，Groovy 可 以 在 语言 级 别 透明 地 调用 Java 程序 。 因 而 ， 使 用 Groovy 可 以 良好 地 兼 
容 历 史 遗 留 项 目 ， 并 且 能 够 运行 在 成 熟 可 靠 的 JPEE Server 之 上 。 

Groovy 有 着 介 于 Java 和 Python 之 间 的 语法 风格 ， 灵 活 不 失 稳重 。 给 Java 程序 员 降 低 
了 学 习 的 门槛 。 


1.3.2 ”Grails 站 在 了 巨人 的 肩膀 之 上 


Grails 在 实现 过 程 中 ， 使 用 了 大 量 成 熟 可 靠 并 为 世人 所 广 为 认 可 的 Java 开源 项 目 。 使 
用 了 Spring MVC 框架 作为 底层 ， 实 现 对 Web MVC 的 支持 ;使 用 了 Hibernate 作为 底层 ， 
实现 GORM (GORM 是 Grails 提供 的 对 象 关系 映射 框架 );， 使 用 Spring IoC 容器 ， 实 现 对 
系统 各 个 模块 的 组 织 与 管理 ， 使 用 SiteMesh， 实 现 对 页 面 布局 (layout) 的 统一 和 简化 。 

有 了 这 些 成 熟 可 靠 的 项 目 作 为 基础 ，Grails 的 可 靠 性 得 到 了 保证 ， 复 杂 性 得 到 了 降低 。 
从 而 使 得 Grails 可 以 在 更 高 的 起 点 上 ， 更 有 效 地 解决 实际 开发 过 程 中 的 问题 。 


1.3.3 ”Grails 有 良好 的 扩展 性 

Grails 采用 了 插件 化 的 设计 架构 ， 不 仅 现 有 的 功能 是 通过 插件 实现 的 (系统 插件 )， 还 
可 以 通过 插件 的 方式 ， 加 入 更 多 新 功能 ， 或 者 对 其 他 的 一 些 流行 框架 (如 Spring Security、 
JQuery 等 ) 进行 整合 。 


目前 Grails 官方 网 站 上 ， 提 供 了 近 百 个 插件 ， 用 以 解决 方方面面 的 问题 。 有 效 地 利用 
这 些 插件 ， 可 以 显著 地 提高 开发 效率 和 降低 开发 的 难度 。 


1.4 对 Grails 的 一 些 误解 


作为 新 兴 事 物 的 Grails， 人 们 还 对 其 存在 一 些 误解 中。 


(1) Grails 还 不 够 成 熟 。 

事实 上 ， 已 经 有 越 来 越 多 的 组 织 和 个 人 选用 Grails 技术 开发 网 站 ，Grails 官方 站 点 已 
经 列 出 了 上 百 个 使 用 Grails 技术 的 成 功 商业 案例 四 .此 外 , 由 于 Grails 本 身 是 基于 Hibernate、 
Spring 和 SiteMesh 这 些 成 熟 完善 的 框架 而 构建 的 ， 因 而 无 需 担 心 它 的 成 熟 程度 。 

(2) Grails 是 否 只 是 Rails 的 一 个 克隆 产物 。 

Ruby on Rails 引入 了 不 少 非常 好 的 主意 ，Grails 将 其 中 的 一 部 分 应 用 到 了 Groovy/Java 
世界 中 ， 并 且 还 加 入 了 许多 Ruby 中 并 不 存在 的 特性 和 概念 ， 所 有 这 些 东 西 都 是 以 一 种 对 
Groovy 和 Java 程序 员 有 意义 的 方式 展现 出 来 的 。 

(3) 有 了 JRuby on Rails 之 后 ， 谁 还 要 Grails 呢 ? 

Grails 的 目标 与 Ruby on Rails 大 为 不 同 。 它 不 是 为 了 在 Groovy 语言 上 实现 一 个 Rails 
的 移植 版 本 , 而 是 将 业界 最 为 强悍 的 组 件 (如 Spring、Hibernate、Quartz、Compass 和 SiteMesh 
等 ) 以 最 佳 方式 组 合 起 来 的 一 个 实践 ， 并 通过 采纳 无 配置 规约 使 它们 符合 “不 重复 (Dont 
Repeat Yourself，DRY)” 的 原则 。Grails 没有 重复 造 轮子 ， 而 且 ， 由 于 Grails 内 核 的 绝 大 
部 分 代码 都 是 以 Java 编写 的 ， 它 也 显得 更 加 强壮 、 稳 定 和 高 效 。 事 实 上 ， 从 内 核 角度 看 
Grails 应 用 ， 只 相当 于 是 一 个 Spring MVC 应 用 ， 因 而 可 以 被 部 署 到 所 有 的 主流 容器 之 上 ， 
包括 大 型 的 商业 容器 ， 如 WebLogic、WebSphere 和 Oracle AS。 


1.5 ”本 书 的 使 用 说 明 


本 书 统一 对 代码 和 控制 台 输入 输出 使 用 Consolas 字体 ， 这 是 一 种 等 宽 的 字体 。 具 体 显 
示 效 果 如 下 : 


对 于 比较 重要 的 内 容 ， 会 标记 为 粗 体 或 粗 斜体 ， 如 以 下 代码 所 示 : 


此 外 ， 对 于 通过 控制 台 输入 的 命令 ,会 使 用 “>” 开 头 ， 如 : 


1.6 本章 小 结 


本 章 对 RoR 的 成 功 进行 了 简单 的 分 析 ， 指 出 了 它 的 一 些 不 足 之 处 。Grails 框架 能 有 效 
地 弥补 RoR 的 这 些 不 足 之 处 ， 因 而 更 适合 作为 Java 程序 员 首选 的 Web 开发 技术 。 本 章 的 
最 后 对 本 书 的 字体 、 格 式 进行 了 简要 说 明 。 


六 门廊 


这 部 分 包含 两 章 ， 这 两 章 将 介绍 一 些 比 较 基 础 的 Grails 和 Groovy 的 知识 ， 
包括 : 如 何 安装 Grails， 如 何 用 Grails 创建 一 个 Web 应 用 程序 ，Groovy 与 Java 
的 简单 对 比 ， 等 等 。 


第 全 章 


2.1 ”Grails 的 安装 


由 于 Groovy 是 运行 在 JVM 之 上 的 语言 ， 所 以 在 安装 Grails 前 ， 应 先 确保 本 机 已 经 安 
装 了 JDK， 并 配置 它 的 环境 变量 。 这 里 要 求 使 用 JDK5.0 以 上 的 版 本 ， 推 荐 使 用 JDK6。 如 
果 没 有 安装 JDK, 可 以 到 SUN 的 主页 http://java.sun.com 下 载 ， 并 完成 其 环境 变量 的 配置 。 
若 已 熟悉 并 安装 了 JDK， 可 跳 过 2.1.1 小 节 ， 直 接 从 2.1.2 小 节 开 始 阅 读 。 


2.1.1 JDK 的 安装 与 配置 


JDK 的 安装 并 不 复杂 ， 只 需要 按照 向 导 的 提示 ， 一 步 步 地 进行 即 可 。 但 安装 完成 后 需 
要 配置 JDK 的 环境 变量 ， 具 体 步 骤 如 下 所 示 。 

(1) 创建 JAVA_HOME 为 JDK 的 安装 目录 ， 如 图 2-1 所 示 。 

(2) 创建 CLASSPATH 为 \;%JAVA_HOME%\lib\tools.jar:%JAVA_HOME%\ib\dtjar， 如 
图 2-2 所 示 。 

(3) 更 新 Path， 加 入 %JAVA_HOME%\bin， 如 图 2-3 所 示 。 


编 驾 系统 变量 


变量 名 0 JAYA_HDWE 


变量 值 9) D:\Program Files\Java\jdkl. 6.0_08 


确定 | | 取消 


图 2-1 将 JDK 安装 目录 设 为 JAVA_HOME 


CLASSPATH 


图 2-2 设置 CLASSPATH 


Pin:NTAVA HouEX\bin: WGRATLS_JONEXbi 


[mm 


图 2-3 将 “%JAVA HOME%\bin” 加 入 Path 


配置 完 环境 变量 后 ， 打 开 一 个 控制 台 ， 输 入 命令 javac -version， 如 果 看 到 如 下 Java 版 
本 号 〈version) 的 提示 ， 说 明 JDK 已 经 安装 配置 成 功 。 


2.1.2 ”Grails 的 安装 


安装 Grails 之 前 ， 首 先 要 下 载 它 的 程序 包 。 可 以 在 Grails 的 官方 主页 
http:/www.grails.org 下 载 到 。 读 者 可 根据 需要 ， 选 择 下 载 不 含 源 程序 的 binary 版 ， 或 下 载 
含 源码 的 Source 版 本 :。 下 载 完 毕 ， 将 其 解压 到 本 机 的 某 一 路 径 下 ， 如 :“D:\”。 

接 下 来 , 需要 配置 Grails 的 环境 变量 。 将 Grails 解压 后 的 路 径 配置 为 GRAILS_HOME， 
如 图 2-4 所 示 。 


Di\grails-1.0.4 


图 2-4 将 Grails 的 解压 路 径 设 为 GRAILS_HOME 
然后 将 %GRAILS_HOME%\bin 添加 到 系统 环境 变量 的 Path 中 ， 如 图 2-5 所 示 。 


变量 名 吕 : Path 
变量 值 7): MEX\bin: NGRAILS_HOMEX\bin; WGROOVY_} 


CJ Co 


图 2-5 将 “%GRAILS HOME%\bin” 加 入 Path 


1 本 书 第 四 部 分 的 章节 会 涉及 到 分 析 Grails 实现 原理 ， 需 要 阅读 Grails 的 源码 。 


Grails 技术 精 解 与 Web 开发 实践 


至 此 ， 安 装 和 配置 
就 说 明 安装 成 功 了 : 


这 样 完成 了 。 打 开 控制 台 ， 输 入 命令 grails， 如 果 看 到 如 下 提示 ， 


>grails 


Welcome to Grails 1.0.4 - http://grails.org/ 

Licensed under Apache Standard License 2.0 

Grails home is set to: D:\grails-1.0.4 

No script name specified. Use 'grails help' for more info or 'grails 


interactive' to enter interactive mode 


如 果 出 现 了 报错 消息 ， 应 检查 JDK 和 Grails 的 环境 变量 是 否 正常 。Linux 下 的 安装 方 
法 和 Windows 下 基本 一 致 ， 也 需要 在 解压 完成 后 配置 环境 变量 。 但 倘若 在 Linux 下 解压 完 
成 后 无 法 运行 grails 命令 , 可 能 还 需要 检查 一 下 bin 目录 下 的 grails 文件 是 否 拥 有 执行 权限 。 

好 了 ，Grails 的 安装 已 经 完成 了 ， 难 以 置信 的 简单 ， 不 是 吗 ? 接 下 来 ， 好 好 地 去 享受 


-下 使 用 Grails 进行 开发 的 乐趣 。 


2.2 创建 Grails 工程 


安装 成 功 后 ， 在 控制 台 输 入 命令 grails help， 会 得 到 一 串 详细 的 命令 列表 ， 如 图 2-6 


所 示 。 


a no er 上 EE 


ng?grails help 


to: D:\grails-1.8.4 


1.0.4\scripts\Help.groovy 
opnent 


Coptionals narked with wy 
: [environnent]» [targe rgunents ]w 


ooks 


vpe srails help ‘target-nane’ for more info):| 


| 


2-6 ”Grails 的 帮助 信息 


这 些 命令 将 为 开发 人 员 的 开发 、 测 试 、 部 署 提 供 巨 大 的 帮助 ， 在 后 面 的 章节 里 会 有 更 
详细 的 介绍 。 这 里 先 使 用 一 个 名 为 create-app 的 命令 ， 去 创建 工程 。 


最 后 一 行 Grails 提示 输入 程序 名 称 。 若 输入 HelloGrails 并 按 Enter 键 , 就 会 发 现 Grails 
创建 了 一 个 工程 ， 该 工程 有 比较 复杂 的 目录 结构 和 一 些 初始 的 文件 : 


Grails 创建 的 HelloGrails 工程 所 包含 目录 结构 的 含义 ， 如 表 2-1 所 示 。 
表 2-1 Grails 生成 的 项 目 目录 结构 


人 is 
BWEB-INF 


工程 根 目录 


存放 配置 信息 ， 包 含 数据 源 、 应 用 程序 启动 时 自动 执行 的 类 
ApplicationBootStrap.groovy, Url 映射 配置 

存放 可 选 的 Spring 配置 文件 

存放 可 选 的 Hibemate 配置 文件 

存放 控制 器 (MVC 的 C) 

存放 域 类 (MVC 的 M) 

存放 国际 化 资源 文件 

存放 service 类 

存放 标签 库 类 

存放 GSP 页 面 (MVC 的 V， 每 个 控制 器 对 应 一 个 文件 夹 并 存放 在 views 
中 ， 每 个 文件 夹 中 会 有 多 个 GSP 页 面 ) 

存放 布局 模板 

存放 工具 方法 类 


存放 单元 测试 代码 
存放 集成 测试 代码 
存放 其 他 jar 包 ( 如 JDBC 驱动 等 ) 


存放 Java 源 程序 
存放 Groovy 源 程序 


存放 CSS 样式 表 
存放 图 片 文件 

存放 JavaScript 文件 
存放 部 署 相关 的 文件 


Dindex.gsp 应 用 程序 默认 的 首页 
这 里 读者 可 以 体会 到 一 点 ，Grails 已 经 帮助 开发 人 员 设 计 好 了 很 多 东西 ， 这 是 它 所 推 


崇 的 约定 胜 于 配置 的 思想 。 这 可 以 让 开发 人 员 把 更 多 精力 集中 在 业务 逻辑 上 ， 而 不 要 为 那 
些 繁琐 的 项 目 配置 浪费 时 间 。 


2.3 ”Grails 的 MVC 架构 


Grails 学 习 了 Rails, 也 采用 了 MVC 架构 ( 见 图 2-7)。 在 Grails 中 ,“M” 指 的 是 Domain 
类 , 可 以 简单 地 将 这 个 Domain 理解 为 数据 库 里 的 一 张 表 , 一 个 Domain 的 实例 则 对 应 为 该 
表 的 一 条 记录 。 通 过 操纵 Domain 类 的 实例 ， 就 可 以 实现 对 数据 库 进行 增删 查 改 操作 。 控 
制 器 “C” 起 到 的 是 一 个 桥梁 的 作用 ， 它 能 够 接收 用 户 提交 的 请 求 ， 它 可 以 调用 M 获取 数 
据 并 把 数据 传递 给 视图 “V”。 视 图 的 作用 是 输出 页 面 ，Grails 中 的 页 面 技术 ， 使 用 的 是 与 
JSP 非常 相似 但 更 加 简单 易 用 的 GSP 技术 ， 可 以 使 用 网 页 编辑 器 进行 编辑 设计 。 


控制 器 
Controller 


1 浏览 器 提交 请 求 


| 一 3. 控 制 器 选择 入 图 
并 将 模型 的 数据 传 给 视图 
ER 


4 视图 向 浏览 器 
输出 页 面 


2-7 MVC 架构 的 Grails 执行 流程 


这 里 的 控制 器 和 视图 是 一 对 多 的 关系 , 也 就 是 说 , 一 个 控制 器 可 能 对 应 多 个 GSP 页 面 。 
每 个 控制 器 都 在 views 文件 夹 中 对 应 一 个 同名 的 文件 夹 ， 而 在 这 个 文件 夹 中 存放 的 就 是 它 
对 应 的 GSP 页 面 。 

举 个 简单 的 例子 ， 这 里 创建 一 个 控制 器 。 用 Grails 的 create-controller 命令 创建 一 个 控 
制 器 。 该 控制 器 命名 为 hello。 


可 以 看 到 Grails 创建 了 控制 器 类 ,在 views 创建 了 名 为 hello 的 文件 夹 ， 还 在 test 中 创 
建 了 默认 的 测试 程序 。 用 任意 的 文本 编辑 器 打开 grails-app\controller\HelloController.groovy 
文件 ， 可 以 看 到 如 下 内 容 : 


这 里 的 def index = {} 是 Groovy 不 同 于 Java 的 一 种 语法 结构 ， 叫 做 闭 包 :。 闭 包 是 一 
段 代 码 的 集合 ， 与 Java 的 方法 类 似 ， 可 以 调用 。 在 Controller 中 ， 闭 包 有 了 新 的 含义 ， 叫 
做 action。Grails 会 根据 请 求 的 URL 决定 调用 哪个 action。 对 上 面 的 代码 进行 简单 的 修改 


然后 执行 Grails 的 mun-app 命令 来 运行 程序 。 
ralsmapp 


当 程 序 运行 完成 后 ， 根 据 控制 台 输 出 的 提示 ， 打 开 任 意 的 浏览 器 ,访问 地 址 
http://localhost:8080/HelloGrails/hello/say， 可 看 到 如 图 2-8 所 示 页 面 。 


文件 旧 入 总 昌吉 看 历史 书签 @ 工具 四 部 助 也 
WH c x a ws (lhw/ochostaoeomeloerais/helo/say 
局 访问 最 多 大 新 手 上 路 让 最 新 头条 a Grails.org News Feed 
| httpy/localhost...rails/hello/say x | 


Hello World! Hello Grails! 


图 2-8 页 面 显示 效果 


不 要 小 看 这 个 例子 ， 它 可 以 帮助 理解 Grails 的 URL 原理 。 一 个 典型 的 Grails 的 URL 
表现 为 如 下 样式 : 


于 是 http://localhost:8080/HelloGrails/hello/say 就 表示 访问 HelloGrails 项 目的 hello 控制 


1 关于 Groovy 语法 的 介绍 可 以 参考 下 一 章 。 


器 的 say action。 不 过 心细 的 读者 可 能 会 问 ，View 的 作用 是 怎么 体现 的 呢 ? 本 例 直 接 使 用 
render 方法 输出 页 面 ， 因 此 其 中 并 没有 体现 出 View 的 作用 。 下 面 把 View 加 入 到 例子 中 ， 
在 grails-app\views\hello 文件 夹 中 创建 一 个 名 为 say.gsp 的 文本 文件 。 输 入 如 下 内 容 : 


然后 修改 HelloContoller 的 内 容 如 下 : 


刷新 页 面 ( 无 需 重启 Grails， 即 重新 运行 ran-app 命令 )， 就 可 以 看 到 实现 效果 了 ， 如 
2-9 所 示 。 


文件 日 编 强 昌 查看 历史 (9 书签 工具 中 和 助人 
WH c x 全 We (lhwp/ochostaoeomeloorais/elo/say 
[3 i a 


Hello World! Hello Grails! 


图 2-9 使 用 GSP 输出 的 页 面 显示 效果 


虽然 看 起 来 和 之 前 的 效果 基本 上 是 一 样 的 ， 但 这 一 次 使 用 了 View (GSP) 来 输出 页 面 
内 容 。 这 里 有 两 个 地 方 需要 重点 关注 一 下 : 一 个 是 Controller 向 GSP 传递 数据 的 方 
式 ，Controller 是 通过 action 的 返回 值 ! 向 GSP 传递 数据 的 ， 这 个 返回 值 是 一 个 Map?， 
Map 的 key 就 成 为 了 GSP 页 面 中 访问 数据 的 变量 名 ; 另 一 个 重要 的 地 方 是 Controller 如 何 
对 GSP 页 面 进行 选取 ， 默 认 情 况 下 ，Controller 会 自动 选择 与 action 同名 的 GSP 去 执行 页 
面 输出 。 

现在 , HelloGrails 里 已 经 包含 了 控制 器 与 视图 。 下面, 我 们 把 模型 引入 进来 , 如 图 2-10 
所 示 。 


1 在 Groovy 中 ， 如 果 方 法 或 闭 包 的 最 后 一 行 是 retum 语句 ， 则 retum 可 以 省 略 。 
? 详 见 下 一 章 对 Groovy 的 集合 、Map 的 介绍 。 


3. 控制 器 跑 转 到 视图 ， 
并 将 模型 的 数据 传 给 视图 


图 2-10 ”当前 例子 中 仅 包含 控制 器 与 视图 


2.4 ”Scaffold 应 用 程序 


Grails 中 的 一 个 Domain 类 ， 可 以 被 简单 地 理解 为 是 数据 库 中 的 一 张 表 。Grails 推荐 的 
开发 方法 与 传统 方法 不 同 : 不 再 是 先 设计 项 目的 数据 库 ， 而 是 开发 人 员 用 OO (Object 
Oriented, 面向 对 象 ) 的 思想 对 数据 进行 OO 建 模 (设计 数据 Domain 类 ), 然后 运行 Grails， 
Grails 会 根据 Domain 类 的 内 容 自 动 地 生成 数据 库 中 的 表 。 当 然 , 这 个 自动 创建 数据 库 不 一 
定 是 最 优 的， 字段 长 度 、 索 引 等 还 需要 由 有 经 验 的 DBA 进行 调整 优化 。 

Grails 在 相当 程度 上 弱化 数据 库 在 项 目 中 的 作用 。 当 然 ， 这 种 自动 创建 的 数据 库 不 可 
能 满足 所 有 的 情况 ， 至 少 对 于 历史 遗留 的 数据 库 就 是 不 适用 的 。 本 书 第 11 章 会 对 GORM 
的 数据 库 映 射 做 深入 的 讨论 ， 这 里 先 只 讨论 最 简单 的 情况 : 单 表 自 动 映射 。 

Grails 中 创建 Domain 的 命令 是 create-domain-class， 如 下 所 示 : 


可 以 看 到 ，Grails 创建 了 两 个 文件 ; 一 个 是 Student 类 ; 另 一 个 是 对 应 的 测试 类 。 使 用 
一 个 文本 编辑 器 打开 grails-app\domain\Student.groovy， 修 改 其 内 容 如 下 : 


这 里 为 Student 类 添加 了 几 个 属性 ， 然 后 为 这 些 属性 添加 了 约束 条 件 : 

(1) name， 长 度 在 3 一 10 之 间 ; 

(2) sid (学 号 )， 为 8 位 数字 ; 

(3) gender 性 别 )， 为 “ 男 ”或 “ 女 ”; 

(4) email， 必 须 为 E-mail 格式 ; 

(5) enrollDate0， 没 有 做 约束 条 件 。 

然后 再 修改 一 下 HelloController 的 内 容 如 下 读者 也 可 以 自己 再 单独 创建 一 个 


Controller): 


重新 运行 程序 (grails run-app) :， 可 以 看 到 一 个 针对 Student 表 的 CRUD 程序 。 首 先 ， 


能 看 到 查看 列表 的 页 面 ， 如 图 2-11 所 示 。 


:GPRIES 


全 Home 加 wewstodent 


Student List 


1 识 t 兴 at1416 angchnongBgmatcom 2008-97-17 22114:00.0 


图 2-11 查看 Student 列表 的 页 面 


还 可 以 单 击 链接 看 到 查看 单条 记录 (明细 ) 的 页 面 ， 如 图 2-12 所 示 。 
当然 ， 也 可 以 在 页 面 上 添加 或 编辑 数据 ， 如 图 2-13 所 示 。 
而 且 这 个 添加 或 编辑 的 页 面 是 有 数据 验证 功能 的 〈 不 过 ， 默 认 的 错误 信息 还 不 够 友 


1 对 于 已 经 在 运行 状态 的 Grails 程序 ， 可 以 在 控制 台 按 CtrltC 键 来 杀 死 进程 。 


好 )， 如 图 2-14 所 示 。 


ERRIES 


例 Home 国 studentuist 局 wew Student 


Show Student 


Sid: 
Gender; 
Email: 


Enroll Date: 


BD edt 局 oelete 


图 2-12 查看 Student 的 页 面 


& Name: 架 + 兴 

梁 二 兴 Ere 

32211416 ii 项 司 

男 

liangshixing@gmailcom > fest om om 

2008-07-17 22:14:00.0 a WW- 硼 -208 7 
局 Se 


图 2-13 编辑 Student 的 页 面 


GBAIES| 


人 Home 并 sadentust 局 NewStudent 
Edit Student 
9 [email 全 


[ood 不 是 一 个 合法 的 电子 邮件 地 址 
[class student) 关 的 图 性 name 区 9 什 [a]b9 大 小 nr [~ (10]) 
【class Student] 类 的 属性 [sidJ9 什 [222 与 定义 的 模式 【\d{8)] 


Nome: dt 

si ss 

Gender: 男 

ea 区 一 

Enroll Date: vt 月 > 208v 227,357 


国 update 局 Delete 


2-14 编辑 Student 的 页 面 〈 含 错误 信息 ) 


这 里 只 用 了 不 到 20 行 代码 ， 花 了 不 到 1 分 钟 ， 就 可 以 完成 这 样 一 个 “复杂 ”的 任务 。 
想象 一 下 对 于 传统 的 SSH (Struts+Spring+Hibermate) 开发 方式 ， 即 使 是 再 熟练 的 程序 员 ， 
也 不 可 能 在 这 么 短 的 时 间 内 完成 这 个 任务 。 这 就 是 Grails 的 魅力 所 在 。 当 然 ，Scaffold 应 
用 的 实用 性 并 不 强 ， 因 为 此 时 的 页 面 是 无 法 自由 定制 的 ， 所 以 在 实际 的 使 用 过 程 中 ， 更 多 
的 是 使 用 Grails 的 generate* 命 令 去 生成 Controller 或 GSP， 这 些 知 识 会 在 后 面 的 章节 中 详 


细 介 绍 。 


细心 的 读者 可 能 会 发 现 一 个 问题 ， 之 前 一 直 在 强调 Domain 是 针对 数据 库 表 的 映射 。 
那 Student 类 映射 的 是 数据 库 的 哪 张 表 ? 配置 过 数据 库 吗 ? 程序 已 经 运行 起 来 了 ， 那 数据 


库 在 哪 ? 


是 的 ， 这 里 并 没有 配置 过 数据 库 ， 但 Grails 默认 捆绑 了 一 个 名 叫 hsqldb 的 数据 库 ， 这 
是 一 个 非常 轻 量 级 的 数据 库 。 虽 然 实际 项 目 中 并 不 推荐 用 它 ， 但 用 它 快 速 实 现 一 个 能 跑 


起 来 的 Scaffold 应 用 ， 却 是 一 个 非常 好 的 选择 。 关 于 数据 库 的 配置 ， 后 面 的 章节 将 会 做 详 
细 的 介绍 , 到 时 候 会 把 数据 库 换 成 MySQL, 并 给 出 MySQL 数据 库 在 Grails 中 的 配置 方法 。 


2.5 ”开发 工具 的 使 用 


读者 可 能 会 奇怪 为 什么 没有 先 介 绍 开发 工具 的 使 用 。 这 其 实 也 体现 了 使 用 Grails、 RoR 
开发 的 一 个 特点 ， 那 就 是 不 强调 工具 的 作用 (这 一 点 正好 与 ASPNET 完全 相反 )。 但 不 管 
怎样 有 工具 的 帮助 对 提高 开发 效率 ， 都 是 有 好 处 的 。 

主流 的 Java IDE, 如 Eclipse、Netbeans、IntelliJ.IDEA 都 可 以 找到 针对 Grails 或 Groovy 
的 插件 。 其 中 对 Grails 支持 比较 好 的 是 Netbeans 6.5 和 IntelliJ.IDEA 7.0。 由 于 Netbeans 是 
免费 的 开源 软件 而 IntelliJ.IDEA 是 收费 的 商业 软件 ， 因 而 强烈 推荐 使 用 Netbeans 6.5 作为 
Grails 的 开发 工具 。 

Netbeans 原本 是 最 优秀 的 Java IDE 之 一 ， 现 在 的 6.5 版 ， 更 是 对 Grails 也 提供 了 强大 
的 支持 。 在 Netbean 的 官方 网 站 http://www.netbeans.org/downloads/index.html， 可 以 下 载 到 
最 新 版 Netbeans， 当 前 的 最 新 版 本 是 6.5。 

若 已 安装 好 Netbeans， 启 动 Netbeans 后 执行 “工具 ”|“ 选 项 ”命令 ， 配置 Grails 的 安 
装 路 径 ， 如 图 2-15 所 示 。 


驳 晶 人 图 上 量 


常规 (6) 编辑 器 E) 。 字体 和 颜色 E) 快捷 键 映射 QD WL 


Ant| Groovy | GUI 生成 器 | JavaSeript | Profiler | Ruby | Wi 


获取 Groovy 的 位 置 http://groovy. codehaus org 
您 的 项 目 将 使 用 在 库 管理 器 中 设置 的 oovysl1 jar 
Groovy 文档 : 

D: \groov1.5. 6\htal 

Grails Home 目录 : 


Di Nerails-1.0.4 


获取 Grails 的 位 置 http://ww eails ore 


图 2-15 在 Netbeans 中 配置 Grails 


可 以 用 Netbeans 打开 刚才 创建 的 Grails 工程 ， 也 可 以 在 Netbeans 中 创建 新 的 工程 。 
Netbeans 对 Grails 支持 有 一 个 非常 好 的 特性 ， 它 是 非 “侵入 性 ”的 。 在 Netbeans 中 新 建 或 
打开 已 有 的 Grails 工程 ， 都 不 会 在 硬盘 上 创建 任何 附加 的 文件 。 使 用 Netbeans 开发 Grails 
应 用 程序 ， 会 带 来 一 些 明显 的 好 处 。 


Netbeans 对 Groovy 语言 提供 了 较 好 的 支持 ， 包 括 代码 高 亮 和 代码 提示 。 尽 管 对 于 脚 
本 语言 来 说 ， 实 现 100% 可 靠 的 代码 提示 是 非常 困难 的 ，Netbeans 的 代码 提示 功能 仍然 可 
以 对 开发 Groovy 程序 带 来 较 大 的 帮助 ， 如 图 2-16 所 示 。 
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图 2-16 ”Netbeans 中 Groovy 的 编辑 效果 


“2: 简便 的 执行 Grails 命令 


在 前 面 的 内 容 中 介绍 了 一 些 Grails 提供 的 命令 ,例如 create-controller、create- 
domain-class 等 。 很 多 用 户 都 不 习惯 在 控制 台 上 输入 命令 ， 而 更 喜欢 通过 可 视 化 的 UI 环境 
编辑 内 容 。Netbeans 为 Grails 的 大 部 分 命令 设计 了 菜单 ， 用 户 可 以 通过 单 击 菜 单 ， 执 行 相 
应 的 操作 ， 如 图 2-17 所 示 。 


| 
文 休 月 _ 编 强 ( 视 画 (V) 号 航 (N) 源 (S) 重 构 (A) 运行 (R) 请 试 (D) 分 析 (P) 版 本 控制 们 工具 (T) 窗口 W) 帮助 中 
上 六 人 = PW:@- 

[em mB teliocomtroller goo * 


加 尼 - 必 -| 及 忌 呆 国人 多 也 虽 上 | 
国 javascript 文 件 。 | Hellocontroller 1 


图 Grails 服务 andex = { 
国 Grais 二 zender ("hello worid".) 


图 2-17 在 Netbeans 中 执行 Grails 命令 


显然 ， 对 于 Web 应 用 的 开发 ，IDE 的 HTML 编辑 能 力 会 极 大 地 影响 程序 的 开发 效率 。 


Netbeans 早 在 3X 的 时 候 就 已 经 提供 了 良好 的 HTML 编辑 能 力 ， 此 外 ， 它 还 提供 了 一 个 可 
视 化 的 CSS 编辑 器 。 这 些 功能 对 于 开发 Grails 应 用 ， 虽 然 不 是 必需 的 ， 但 无 疑 可 以 明显 地 
改善 开发 效率 和 质量 。 


图 2-18 可 视 化 的 CSS 编辑 器 


事实 上 ，Netbeans 提供 的 功能 远 远 不 止 上 面 介 绍 的 这 些 。 要 了 解 更 多 Netbeans 相关 的 
知识 ， 可 以 参考 它 的 帮助 文档 。 


2.6 ”本 章 小 结 


本 章 创 建 了 第 一 个 Grails 程序 。 从 Grails 的 安装 开始 ， 用 Grails 的 create-app 命令 创 
建 了 一 个 HelloGrails 项 目 。 然 后 讨论 了 一 个 Grails 的 MVC 结构 ， 用 create-controller 命令 
创建 了 一 个 名 为 hello 的 Controller， 通 过 它 学 习 了 Grails 的 URL 中 Controller 与 action 的 
组 织 方式 。 接 着 ， 用 create-domain-class 命令 创建 了 一 个 Domain 类 ， 在 Controller 中 用 了 
一 行 代码 “def scaffold = Student” 就 为 它 生 成 了 可 以 进行 增删 查 改 的 CRUD 页 面 。 本 章 的 
最 后 部 分 ， 简 单 介 绍 了 如 何 使 用 Netbeans 工具 开发 Grails 应 用 ， 在 IDE 帮助 下 ，Grails 应 
用 的 开发 会 变 得 更 加 容易 。 


Groovy VS Java 
第 3 章 


上 一 章 ， 读 者 对 Grails 有 了 一 点 初步 的 认识 ， 但 对 上 一 章 中 的 代码 ， 可 能 多 少 会 有 些 
不 适应 ， 毕 竟 Groovy 不 是 Java。 引 用 Groovy 官方 的 说 法 : 它 是 运行 在 JVM 之 上 的 敏捷 
动态 语言 ， 它 基于 Java 却 为 Java 带 来 了 大 量 强大 的 新 特性 ， 这 些 特 性 源 于 Python、Ruby 


和 Smalltalk 。 


Groovy 的 灵活 与 简单 ， 使 得 大 量 基于 Groovy 的 DSL (Domain Specified Language， 某 


一 领域 的 专用 语言 ) 被 开发 出 来 。 使 用 DSL， 使 得 很 多 原本 复杂 的 任务 得 到 简化 ， 例 如 


» 


查询 数据 库 、 解 析 XML、 使 用 Swing 开发 桌面 应 用 、 配 置 Spring 等 。Grails 正 是 充分 利用 


了 Groovy 的 这 些 特 性 ， 开 发 了 大 量 的 DSL， 从 而 简化 了 Web 应 用 的 开发 。 


本 章 的 目标 就 是 通过 使 用 尽 可 能 少 的 文字 ， 对 Groovy 语言 与 Java 的 区 别 做 概要 性 的 
介绍 ， 使 得 读者 在 阅读 后 面 章节 的 时 候 不 会 有 太 多 语法 上 的 障碍 。 对 于 已 经 了 解 Groovy 


语法 的 读者 ， 本 章 可 以 跳 过 不 看 ， 直 接 阅 读 后 面 的 内 容 。 


本 章 的 例子 程序 不 需要 在 Grails 环境 中 运行 ， 读 者 可 以 下 载 并 安装 独立 的 Groovy 到 
本 机 ， 有 具体 做 法 与 Grails 的 安装 相似 : 首先 下 载 Groovy 的 安装 包 (可 以 在 http://groovy. 
codehaus.org 下 载 ); 解压 到 本 机 的 相关 目录 下 , 然后 配置 环境 变量 , 如 图 3-1、 图 3-2 所 示 。 


编辑 系统 变量 


变量 名 名 GROOVY_HOME 
变量 值 W) 和 :ezoo-1 5 6] MEX\bin; WGRDOVY_HONEX\bin; WSystemRo 


[mm | 


3-1 ”Groovy 的 环境 变量 (1) 图 3-2 ”Groovy 的 环境 变量 (2) 
然后 在 控制 台 输入 groovy -v， 如 果 看 到 如 下 提示 ， 说 明 安装 成 功 了 。 


>groovy -v 
Groovy Version: 1.5.6 JVM: 10.0-b22 


Groovy 给 用 户 提 供 了 一 个 小 巧 易 用 的 工具 ， 用 于 运行 简单 的 Groovy 代码 。 执 行 “ 开 


始 ” 一 “运行 ”命令 ,在 弹出 的 对 话 框 中 输入 groovyConsole， 会 启动 一 个 基于 Swing 的 
形 窗口 ， 可 以 在 里 面 编写 简单 的 Groovy 程序 ， 如 图 3-3 所 示 。 


图 


执行 ScriptlRun 命令 ， 可 以 运行 程序 ， 执 行 ScriptlIRun Selection 命令 可 以 只 运行 选中 


的 代码 ， 十 分 方便 。 接 下 来 进入 Groovy 的 正题 。 


国 |3 el| 才 中 人 四 | 曲 旦 | 所 本 | 局 


println “hello world"| 


3-3 ”Groovy 控制 台 


3.1 ”Groovy 的 基本 类 型 与 运算 符 


在 Groovy 中 ， 一 切 都 是 对 象 。 这 点 与 Java 不 同 ，Java 中 int、double 等 类 型 为 基本 类 
型 ， 其 变量 不 是 对 象 ， 而 在 Groovy 中 ， 任 何 变量 都 是 实 实在 在 的 对 象 。 

运算 符 在 Groovy 中 相当 于 是 Groovy 对 象 的 方法 ， 因 而 可 以 很 容易 地 对 运算 符 进行 
重 载 。 


3.1.1 字符 串 


在 Groovy 中 ， 字 符 串 的 功能 变 得 更 加 强大 ， 字 符 串 的 使 用 变 得 更 加 简单 。 

单 引号 “'” 双 引 号 “"” 和 斜 本 “/” 都 可 以 表示 字符 串 。 

单 引 号 “'” 表 示 静 态 的 字符 串 ， 与 Java 中 的 字符 串 功 能 类 似 ， 双 引号 “"” 表 示 的 是 
动态 的 字符 串 ， 这 是 动态 语言 所 独 有 的 特性 ;“/” 用 于 定义 无 转 义 符 的 字符 串 ， 常 用 于 书 
写 正则 表达 式 ， 如 下 面 的 一 些 实例 所 示 。 


这 里 的 def 是 Groovy 中 定义 变量 的 最 常见 的 方法 ， 它 表示 要 定义 一 个 变量 ， 而 不 关心 


这 个 变量 是 什么 类 型 ， 变 量 的 类 型 取决 于 给 它 赋值 的 类 型 。 这 种 类 型 动态 化 的 特点 ， 是 动 
态 语言 区 别 于 静态 语言 的 一 个 重要 标志 。assert 是 Groovy 的 一 个 常用 的 方法 : 断言。 含义 
是 若 断 言 的 内 容 为 假 ， 则 报 异常 退出 程序 。 

如 果 连 续 使 用 3 个 引号 (“""” 或 “"”)， 则 表示 字符 串 段落 : 


字符 串 常见 的 运算 符 操作 : 


ab 的 结构 在 Groovy 中 叫做 区 间 (Range)， 后 面 的 小 节 会 有 介绍 。 
字符 串 常见 的 方法 : 


3.1.2 ”数字 


Groovy 中 的 数字 是 对 象 ， 因 而 可 以 在 数字 上 调用 方法 : 


Groovy 的 数学 运算 默认 会 有 较 高 计算 精度 〈 因 为 使 用 了 BigDecimal 类 型 ); 2/3 的 结 
果 不 是 0 而 是 0.6666666667。 如 果 想 要 得 到 与 Java 程序 类 似 的 计算 结果 , 需要 使 用 intdiv0 
We 


3.1.3 ”Groovy 的 类 


Groovy 中 类 的 定义 与 Java 相 比 区 别 不 大 ， 额 外 注意 以 下 两 点 即 可 。 

一 个 特点 是 存在 基于 Map 初始 化 的 默认 构造 函数 : Groovy 的 类 默认 情况 下 无 需 用 
户 实现 ) 可 以 使 用 一 个 Map 作为 构造 函数 的 参数 ， 对 象 的 属性 会 被 Map 的 同名 key 所 对 
应 的 值 初始 化 。 


另 一 个 特点 是 属性 字段 。 在 Groovy 中 ， 没 有 定义 访问 限定 符 〈 如 public、private、 
protected) 的 字段 ， 表 示 该 字段 是 一 个 属性 。 这 点 不 同 于 Java。Java 类 中 默认 的 访问 域 是 
package， 但 在 Groovy 中 ， 默 认 是 属性 域 。 


在 Groovy 的 写法 中 ， 上 述 两 个 类 是 完全 等 价 的 。 但 明显 前 者 的 代码 要 少许 多 。 同 时 ， 
访问 对 象 属性 的 过 程 也 被 简化 了 。 调 用 a.pl 和 调用 a.getP10 是 等 价 的 ， 调 用 apl=XX 与 
a.setP1 (XX) 还 是 等 价 的 。 

Groovy 还 给 用 户 提供 了 一 个 非常 实用 的 运算 符 :“?”。 例 如 ， 当 要 访问 ab.c 的 时 候 ， 
难免 要 做 一 些 判断 以 保证 a 和 都 不 是 null， 否 则 一 旦 为 空 ， 将 会 抛 出 异常 。 写 出 来 的 代 
码 就 应 该 是 这 样 : 


这 里 有 比较 多 的 让 和 else。Groovy 中 的 写法 是 : 
上 
怎么 样 ? 简单 而 又 实用 吧 ! 


运算 符 


3.1.4 


Groovy 中 的 运算 符 大 多 会 对 应 为 一 个 Groovy 类 的 成 员 方法 。 例 如 ,“+” 运 算 符 实 
际 上 是 调用 了 对 象 的 plus 方法 。 表 3-1 列 出 了 Groovy 中 常见 的 运算 符 和 对 应 的 类 成 员 


方法 。 


右 移 位 运算 
无 符号 的 右 移 位 
运算 


表 3-1 Groovy 基于 方法 的 运算 符 


Number string. collection 
Number string. collection 
Number. string, collection 
Number 

integral number 

Number, string. range 


integral number 
integral number 
integral number 


integral number string (~ 运算 符 后 面 的 返 
回 一 个 正则 表达 式 ) 

Object. list map. String Array 

Object. list. map. StringBuffer. Array 
integral number 也 用 于 StringBuffers, 
Writers, Files. Sockets. Lists 的 合并 
integral number 

integral number 


续 表 


switch(a){ ”分 类 bisCase(a) Object range. list. 
case b: collection. pattern, closure: 
也 用 于 从 集合 c 中 查找 所 有 符合 条 件 b 的 
items, c.grep(b) b.isCase(item) 
= 相等 a.equals(b) Object 
al=b 不 等 于 ! a.equals(b) Object 
a<=>b 比较 运算 符 , 大 于 ”a.compareTo(b) java.lang.Comparable 
返回 1, 小 于 返回 
-1， 等 于 返回 0 
a>b 大 于 a.compareTo(b) > 0 
a>=b 大 于 或 等 于 a.compareTo(b) >= 0 
a<b 小 于 a.compareTo(b) <0 
a<=b 小 于 或 等 于 a.compareTo(b) <= 0 


a as type 强制 类 型 转换 a.asType(typeClass) 任意 类 型 


如 果 想 让 自己 定义 的 类 能 够 支持 运算 符 ， 只 需要 它 提供 了 相应 的 方法 即 可 ， 例 如 ， 定 
义 复数 类 如 下 : 


3.2 ”Groovy 的 控制 结构 


Java 的 控制 结构 不 外 平 是 :站 语 句 、switch 语句 、for 循环 、while 循环 和 do 循环 ,Groovy 
在 这 一 点 上 ， 和 Java 是 一 样 的 。 早 期 版 本 的 Groovy 不 支持 Java 风格 的 for 循环 , 但 从 1.5 
版 开始 就 支持 了 。 

Groovy 的 站 与 Java 有 一 定 区 别 。Groovy 的 站 可 接受 的 类 型 不 仅仅 是 boolean， 还 可 
以 是 数字 、 字 符 串 、 对 象 、 集 合 。 当 传 入 boolean 或 Boolean 时 ， 处 理 逻 辑 与 Java 相同 ; 
当 传 入 数字 时 ， 非 0 为 真 ，0 为 假 ， 当 传 入 字符 串 时 ， 空 字符 串 "" 为 假 ， 其 他 为 真 ， 当 传 


入 集合 时 ， 元 素 个 数 等 于 0 为 假 ， 元 素 个 数 大 于 0 为 真 ， 当 传 入 一 个 普通 object 时 ，null 
为 假 ， 否 则 为 真 。 下 面 是 一 些 使 用 举例 。 


这 个 特性 可 以 帮 有 程序 员 减 少 很 多 没 必要 的 代码 ， 事 实 上 这 个 特性 是 源 于 Groovy 的 类 
型 转换 。 上 面 的 几 种 类 型 在 转换 为 boolean 时 ， 会 使 用 上 述 的 转换 逻辑 。 换 名 话说， 除了 
让 语句 外 ，Groovy 的 while 循环 、do 循环 等 一 切 需要 进行 “ 真 ““ 假 ”判断 的 地 方 ， 都 有 
上 述 的 特性 。 

Groovy 的 for 循环 支持 两 种 风格 : 一 种 是 传统 Java 风格 ; 另 一 种 是 集合 遍历 风格 ( 关 
于 集合 的 知识 下 一 节 会 有 介绍 )。 其 使 用 如 下 例 所 示 : 


switch 语句 的 功能 在 groovy 中 得 到 了 不 小 的 增强 ，case 子 句 内 可 以 进行 多 种 复杂 的 
判断 : 


3.3 ”Groovy 的 集合 


Groovy 中 有 常用 的 3 种 集合 类 型 ， 分 别 是 列表 List、 映 射 Map 和 区 间 Range。 
3.3.1 列表 


Groovy 中 列表 的 本 质 就 是 javautiLList, 但 Groovy 提供 了 大 量 能 够 简化 其 操作 的 特性 。 
List 的 初始 化 代码 可 以 简化 ， 只 需要 在 [] 中 直接 写 入 初始 的 数据 即 可 : 


List 支持 大 量 的 运算 符 和 方法 : 


List 有 一 个 非常 有 用 的 运算 符 “*”， 它 的 含义 是 依次 对 List 每 个 元 素 调 用 “* ”后 面 的 


3.3.2 映射 


Groovy 中 的 映射 本 质 上 就 是 Java 的 javautiLMap， 但 Groovy 中 的 Map 在 创建 和 使 用 
时 都 更 加 简单 。 创 建 Map， 用 key:value 的 形式 成 对 出 现 ， 初 始 化 时 的 key 默认 会 被 当 作 字 
符 串 处 理 ， 其 使 用 如 下 例 所 示 : 


可 能 会 有 读者 提出 问题 ， 如 果 keyl 是 个 变量 会 怎样 ? 下 面 的 代码 可 以 解释 这 个 问题 : 


相信 从 上 面 代码 中 ,读者 一 定 能 找到 答案 : 在 初始 化 Map 时 ， 如 果 想 用 某 一 变量 的 值 
作为 key， 需 要 用 括号 将 该 变量 括 起 来 。 
为 初始 化 过 的 Map 添加 和 删除 key 是 非常 容易 的 ， 如 下 例 所 示 : 


3.3.3 ”区间 


区 间 是 Groovy 特有 的 一 种 数据 结构 。 虽 然 它 的 名 字 起 的 很 数学 化 ， 但 它 却 是 非常 实 
用 的 。 区 间 的 定义 非常 简单 ， 共 有 两 种 形式 : 一 种 为 闭 区 间 “ 起 始 .. 结 束 ”， 另 一 种 为 左 闭 
右 开 区 间 “ 起 始 .< 结束 ” 如 下 是 一 些 实例 代码 : 


事实 上 ， 区 间 使 用 的 数据 类 型 并 不 局 限于 数字 、 字 符 串 、 日 期 等 一 切实 现 了 next0 和 
previous0 方 法 的 类 型 (回顾 一 下 介绍 运算 符 的 小 节 , 这 两 个 方法 对 应 的 是 ++ 和 -一 运算 符 )， 
都 可 以 定义 为 区 间 ， 如 下 例 所 示 : 


区 间 类 型 最 常见 的 用 法 是 用 于 循环 和 switch 语句 ， 如 下 例 所 示 : 


前 置 “*” 运 算 符 可 以 把 区 间 展 开 ， 用 于 构造 List， 例 如 : 
assert [y rangell = [2345 


3.4 ”Groovy 的 闭 包 


3.4.1 闭 包 的 定义 


闭 包 〈Closure) 是 Java 所 不 具备 的 语法 结构 。 闭 包 就 是 一 个 代码 块 ， 用 “{ }” 包 起 
来 。 此 时 ， 程 序 代码 也 就 成 了 数据 ， 可 以 被 一 个 变量 所 引用 (与 C 语言 的 函数 指针 比较 类 
似 )。 闭 包 的 最 典型 的 应 用 是 实现 回调 函数 《callback)。Groovy 的 API 大 量 使 用 闭 包 ， 以 
实现 对 外 开放 。 闭 包 的 创建 过 程 很 简单 ， 例 如 : 


参考 下 面 的 例子 代码 ， 定 义 了 cl 和 c2 两 个 闭 包 ， 并 对 它们 进行 调用 : 


“->” 之 前 的 部 分 为 闭 包 的 参数 ， 如 果 有 多 个 参数 ， 之 间 可 用 逗号 分 割 ;“->” 之 后 的 
部 分 为 闭 包 内 的 程序 代码 。 如 果 省 略 了 “->” 和 它 之 前 的 部 分 ， 此 时 闭 包 中 代码 ， 可 以 用 
名 为 “it” 的 变量 访问 参数 。 

闭 包 的 返回 值 和 函数 的 返回 值 定义 方式 是 一 样 的 如果 有 retum 语句 ， 则 返回 值 是 


retum 语句 后 面 的 内 容 ， 如 果 没有 retum 语句 ， 则 闭 包 内 的 最 后 一 行 代码 就 是 它 的 返回 值 。 
3.4.2 闭 包 的 代表 


每 个 闭 包 都 有 一 个 代表 (delegate) 属性 ， 指 定 了 闭 包 的 代理 对 象 ( 闭 包 可 以 直接 访问 
该 对 象 的 成 员 方法 和 属性 ), 通过 delegate 可 以 访问 代表 对 象 。 默认 情况 下 , delegate 与 this 
是 相同 的 ， 但 可 以 手动 修改 delegate 的 值 ， 使 闭 包 访问 其 他 对 象 的 方法 和 属性 ， 例 如 : 


代码 运行 的 输出 结果 为 : 


因为 闭 包 c2 是 全 局 闭 包 ， 所 以 它 的 delegate 就 是 全 局 的 Script 类 ， 于 是 第 一 行 会 输出 
ScriptXX。 当 执行 完工 1 后 ， 会 将 foo 对 象 设置 成 为 c2 的 delegate， 于 是 此 后 执行 L2 时 会 


输出 class Foo; 同 理 ， 在 设置 了 c2 的 delegate 为 foo 后 ，c2 的 内 部 就 可 以 访问 foo 的 成 员 
方法 method0 了， 所 以 此 时 不 会 报错 。 


3.4.3 闭 包 在 GDK 中 的 使 用 


GDK (Groovy Development Kit) 中 有 大 量 的 API 是 针对 Closure 进行 操作 的 。 


表 3-2 常见 的 以 闭 包 为 参数 的 方法 


可 以 进行 遍历 ， 每 次 取 集 合 的 一 个 元 素 传 入 的 闭 包 


findAll 遍历 集合 ， 每 次 取 和 集合 的 一 个 元 素 传 入 的 闭 包 ， 将 能 使 闭 包 返回 真 的 元 素 组 成 一 
个 新 的 集合 

collect 遍历 集合 ， 每 次 取 集 合 的 一 个 元 素 传 入 的 闭 包 ， 将 闭 包 的 返回 值 构造 成 一 个 新 的 
集合 

any 遍历 集合 ， 依 次 取 集 合 的 一 个 元 素 传 入 的 闭 包 ， 若 有 一 个 元 素 能 使 闭 包 返回 真 
则 立即 返回 真 ， 若 没有 元 素 能 使 闭 包 返 回 真 ， 则 返回 假 

every 遍历 集合 ， 依 次 取 集 合 的 一 个 元 素 传 入 的 闭 包 ， 若 全 部 元 素 都 能 使 闭 包 返回 真 ， 
则 返回 真 ， 若 有 一 个 元 素 能 使 闭 包 返回 假 ， 则 返回 假 

下 面 对 每 种 方法 分 别 举例 说 明 。 


1 Groovy 中 在 调用 带 参数 的 方法 的 时 候 ， 可 以 不 写 0， 如 “(1..10).each { .… }”。 笔 者 不 十 分 推荐 这 么 
做 ， 毕 竟 多 写 一 个 括号 费 不 了 多 大 功夫 ， 但 对 理解 程序 结构 会 更 加 容易 。 


| 


| 


[一 一 一 一 一 


CE 


(一 一 一 


可 应 用 于 闭 包 的 特殊 运算 符 :“ 引 用 .&” 可 以 把 一 个 普通 的 Groovy 方法 转换 为 闭 包 。 


3.5 ”本 章 小 结 


本 章 对 Groovy 的 语法 知识 做 了 简单 的 介绍 ， 分 别 介 绍 了 Groovy 的 基本 类 型 、 集 合 类 
型 、 控 制 结构 和 闭 包 。 本 章 的 目的 就 是 通过 尽 可 能 少 的 文字 ， 帮 助 读者 了 解 Groovy， 使 读 
者 朋友 在 有 了 一 定 的 基础 后 ， 阅 读本 书后 面 章节 的 代码 不 再 因 语 法 问题 而 产生 困惑 。 接 下 
来 将 使 用 Grails 开发 一 个 实用 的 Web 应 用 程序 。 


实际 应 用 


这 部 分 包含 7 章 , 这 几 章 将 一 步 步 地 完成 一 个 购物 车 的 应 用 。 该 部 分 包含 
商品 维护 、 商 品 搜 索 、 用 户 的 注册 与 登录 、 创 建 购物 车 、 下 订单 、 系 统 后 台 管 
理 、 页 面 布局 的 统计 设计 、 自 动 化 测试 、 应 用 的 部 署 等 。 通 过 这 个 应 用 ， 读 者 
可 以 学 习 到 Grails 多 方面 的 知识 ， 可 以 解决 许多 在 使 用 Grails 开发 的 过 程 中 会 
遇 到 的 问题 。 


商品 维护 
第 4 章 


4.1 准备 工作 


回顾 一 下 前 面 的 章节 ， 可 以 知道 ， 创 建 一 个 Grails 的 应 用 其 实 并 不 复杂 。 购 物 车 的 应 
很 具有 代表 性 ,可 以 涉及 到 Web 开发 的 大 多 数 基础 知识 ， 因 此 这 里 选用 购物 车 做 为 应 用 
实例 。 考 虑 到 准备 用 Grails 开发 的 购物 车 ， 就 叫 它 GDepot。 好 了 ， 让 代码 运行 起 来 再 说 。 
执行 命令 : 


>grails create-app GDepot 


Grails 帮 用 户 创建 好 了 应 用 程序 框架 ,并 且 组 织 好 了 目录 结构 。 这 一 次 不 再 使 用 Grails 
提供 的 hsqldb 数据 库 ， 换 用 高 性 能 的 开源 数据 库 MySQL， 因 而 需要 调整 数据 源 的 配置 。 

由 于 Groovy 程序 本 质 上 也 是 Java 程序 ， 因 此 也 需要 使 用 JDBC 驱动 进行 数据 库 的 连 
接 。 首 先 把 MySQL 的 JDBC 驱动 的 jar 包 (可 以 从 MySQL 网 站 上 下 载 到 ) mysql- 
connector-java-5.1.6-bin.jar 复制 到 项 目 文件 夹 的 lib 目录 中 去 。 然 后 修改 数据 源 的 配置 ， 打 
开 grails-app\conf\DataSource.groovy。 


dataSource { 

pooled = true 

driverClassName = "com.mysql.jdbc.Driver" 

username = "root" 

password = "mysgl" 
} 
hibernate { 

cache.use second level cache=true 

cache.use query_ cache=true 

cache.provider class= 

"com.opensymphony.oscache.hibernate.0OSCacheProvider' 

1 
// environment specific settings 
environments { 

development { 

datasource { 


dbCreate = "update" // one of 'create', 'create-drop', 'update' 


EE 


代码 中 粗 体 + 斜体 的 部 分 就 是 需要 修改 的 内 容 。dataSource 节点 用 于 配置 数据 源 ， 如 果 
将 数据 源 改换 为 MySQL, 就 要 修改 其 中 的 driverClassName 以 及 用 户 名 和 密码 。 在 hibernate 
节点 中 可 以 配置 缓存 相关 的 内 容 ， 这 一 部 分 会 在 后 面 有 详细 介绍 ， 这 里 先 使 用 默认 值 。 
environments 中 包含 了 3 个 结构 相同 的 子 内 容 ， 分 别 对 应 开发 环境 、 测 试 环境 和 产品 环境 。 
每 一 部 分 又 分 别 对 应 数据 库 的 创建 策略 〈 没 错 ， 数 据 库 是 程序 自动 创建 的 ) 和 连接 数据 库 
的 URL。Grails 的 3 种 数据 库 创建 策略 dbCreate 分 别 表 示 如 下 含义 : create-drop， 当 Grails 
运行 时 ， 如 果 目 标 数据 库 已 存在 ， 则 drop 删 掉 它 并 重新 创建 create， 当 Grails 运行 时 ， 
如 果 数 据 库 不 存在 ， 创 建 数据 库 ， 但 如 果 目 标 数据 库 已 存在 ， 原 有 数据 库 的 结构 不 会 进行 
修改 ， 会 删除 已 有 数据 : update， 如 果 目 标 数据 库 不 存在 ， 则 创建 数据 库 ， 如 果 数据 库 已 
存在 ， 则 根据 需要 (通常 是 Domain 类 的 内 容 变 了 )， 自 动 更 新 数据 库 。 当 然 ， 还 可 以 选择 
不 让 Grails 自动 创建 数据 库 ， 只 要 删除 这 个 dbCreate 选项 就 可 以 了 1。 

传统 项 目 开 发 过 程 有 对 数据 库 进行 ER 建 模 的 步骤 ， 在 Grails 中 已 经 不 再 存在 。 取 而 
代 之 的 是 针对 Domain 的 OO 建 模 。 程 序 员 按 照 OO 的 思想 和 方式 设计 好 Domain 类 ,然后 
由 Grails 创建 基于 该 Domain 类 的 数据 库 表 。 当 然 ，Grails 自动 生成 的 数据 库 不 一 定 是 最 优 
的 ， 还 需要 DBA 进行 相应 的 优化 。 

这 里 首先 创建 商品 和 分 类 的 Domain 类 : 


可 以 在 grails-app\domain 目录 下 看 到 Category.groovy 和 Goods.groovy 两 个 文件 ， 分 别 
修改 它们 的 内 容 如 下 : 


1 这 里 强烈 建议 不 要 在 product 环境 中 使 用 dbCreate 选项 ， 产 品 环境 的 数据 库 应 该 是 由 DBA 创建 的 
经 过 优化 的 数据 库 。 


这 里 指定 了 商品 和 分 类 的 属性 〈 字 段 )， 同 时 指定 了 商品 和 分 类 的 关系 是 一 对 多 的 关 
系 。Category 类 中 的 constraints 闭 包 ， 定 义 了 对 Category 表 中 数据 的 约束 条 件 ， 即 为 
categoryName 字段 添加 唯一 性 约束 !。 接 下 来 就 运行 程序 ,看 看 它 自动 生成 的 表 是 什么 样子 。 
运行 命令 : 


很 不 幸 ， 可 能 会 看 到 这 样 的 报错 : 


其 实 道理 很 简单 ， 在 配置 DataSource.groovy 的 时 候 ， 指 定 的 URL 中 包含 了 数据 库 的 
名 称 。 但 是 , 显然 在 尚未 创建 该 数据 库 时 , 使 用 这 样 的 URL 不 可 能 成 功 连接 数据 库 。 因而 ， 
必须 先 手动 创建 这 3 个 环境 的 数据 库 : 


1 要 了 解 更 多 数据 约束 与 验证 的 知识 ， 详 见 第 6.1 节 表 单 验 证 与 资源 文件 。 


创建 好 数据 库 后 〈 其 实现 在 只 创建 一 个 dev 环境 就 够 了 )， 再 次 运行 程序 : 


这 一 次 ， 程 序 可 以 正常 地 运行 起 来 了 。 从 数据 库 中 ， 可 以 看 到 Grails 创建 了 两 张 表 ， 
并 为 它们 建立 了 外 键 : 


Grails 为 每 张 表 自动 创建 了 一 个 名 叫 id 的 主键 ， 和 一 个 version 字段 ( 源 于 Hibernate 
的 乐观 锁 (optimistic locking) 机 制 )。 并且 goods 表 中 的 category_id 字段 实现 了 与 category 
表 的 关联 。 

修改 一 下 grails\config\BootStrap.groovy 文件 的 内 容 , 让 程序 启动 时 自动 添加 几 条 数据 ， 
修改 情况 如 下 所 示 : 


这 样 在 程序 启动 时 ，Grails 会 自动 添加 一 条 商品 分 类 和 两 件 商品 。 
4.2 ”查看 商品 列表 


完成 了 准备 工作 ， 这 里 有 了 数据 库 和 少量 初始 数据 。 这 一 节 将 介绍 : 如 何在 页 面 上 输 
出 数据 、 如 何 用 标签 去 遍历 一 个 列表 、 
如 何 去 构 造 超级 链接 。 

首先 , 让 Grails 生成 这 两 个 Domain 
的 CRUD 页 面 ， 命 令 如 下 : 


重新 运行 程序 , 可 以 看 到 Grails 自 
动 创建 了 两 个 骨架 程序 ， 可 以 通过 浏 
览 器 访问 http://localhost:8080/GDepot/ 
goods/list， 显 示 效 果 如 图 4-1、 图 4-2、 
图 4-3 所 示 。 


Ws 


Create Goods 
日 1 

Cateooy: [Categoy :1 > 

a Category: Category : 1 
Description: = Grails Book.. 
Photourl: 
Price: 20.0 
Title: Grails 


图 4-2 创建 商品 图 4-3 商品 明细 


虽然 客户 不 可 能 对 这 样 的 页 面 满意 ， 但 至 少 最 基本 的 CRUD 功能 已 经 实现 了 。 那么 接 
下 来 ， 就 着 手 去 改进 它 。 首 先 ， 要 修改 显示 商品 列表 的 页 面 (grailsvview\goods\listgsp )， 
如 下 所 示 : 


修改 一 下 商品 列表 的 显示 方式 ， 然 后 用 它 的 编辑 界面 修改 两 条 商品 的 记录 ， 使 它 的 
pictureUrl 不 再 为 空 ， 于 是 ， 再 看 商品 列表 的 界面 ， 是 不 是 就 舒服 些 了 ， 如 图 4-4 所 示 。 


站 


图 4-4 经 过 调整 后 的 商品 列表 页 面 ' 


1 两 个 商品 的 图 片 的 pictureUal 分 别 是 http://otho.douban.com/lpic/s3032092.jpg 和 http://otho.douban. 
com/lpic/s3369439.jpg。 


这 个 页 面 功能 虽然 简单 ， 还 是 需要 细 细 品味 一 下 。 前 面 的 第 2.3 节 介 绍 了 Grails 页 面 
的 请 求 过 程 ， 首 先是 执行 Controller，Controller 可 以 接收 用 户 提交 的 表单 ， 可 以 为 页 面 显 
示 准 备 数据 .因此 ,要 了 解 list 这 个 页 的 执行 过 程 ,就 要 先 看 GoodsController 类 的 list action: 


这 里 调用 了 Goods 类 的 list 方法 ， 实 现 对 数据 库 Goods 表 的 查询 。 

Goods 类 的 代码 是 程序 员 亲 手 编写 的 ， 程 序 员 从 来 没 给 它 添加 过 什么 list 方法 ， 但 这 
里 确实 是 调用 了 list 方法 实现 对 数据 库 的 查询 。 动 态 语 言 可 以 在 运行 时 改变 行为 ， 使 已 有 
的 类 增加 新 的 方法 或 属性 ,Groovy 语 言 可 以 通过 metaClass 实现 上 述 功 能 这 里 不 对 Domain 
查询 数据 库 的 原理 进行 过 多 的 阐述 ， 在 最 后 的 第 四 部 分 将 进行 深入 的 讨论 。 

GSP 页 面 上 可 以 访问 Controller 中 action 所 返回 值 (Map) 中 的 数据 ， 即 goodsInstanceList。 
并 且 在 GSP 页 面 中 使 用 一 个 <g:each> 标 签 来 对 这 个 List 的 内 容 进 行 遍历 ， 例 如 : 


g:each 标签 包含 3 个 属性 : in 为 必 选 ， 指 定 表示 需要 遍历 的 集合 ;status 为 可 选 ， 返 回 
当前 对 应 的 索引 《 行 号 );。 var 为 可 选 ， 用 于 指定 每 次 取出 元 素 的 名 称 ， 如 果 不 指 定 var 属 
性 ， 则 自动 指派 为 t。 通 过 g:each 标签 ， 实 现 了 把 数据 库 的 每 条 记录 显示 为 表格 的 一 行 。 

$ 人 可 以 对 “人 ”内 部 的 表达 式 进行 计算 ， 然 后 输出 其 计算 结果 。 例 如 : 


这 将 在 页 面 上 输出 goodsInstance.category?.categoryName 的 值 。 

$ {fieldValue(bean:goods, field:title)}， 会 输出 fieldValue 方法 的 执行 结果 。 它 的 作用 是 
取出 某 一 个 bean 的 某 一 个 field 的 值 ( 这 个 方法 比较 智能 ， 能 够 判断 该 field 的 取 值 是 否 合 
法 ， 还 能 自动 进行 encodeAsHtml0 操 作 ， 以 防止 跨 站 脚本 攻击 ， 因 此 推荐 使 用 )。 

g:link 是 用 于 输出 超级 链接 的 标签 ， 这 也 是 Grails 中 最 常见 的 一 个 标签 。 可 以 通过 指 
定 controller 和 action 属性 构造 链接 ， 也 可 以 通过 id 或 params 属性 传递 参数 ， 如 果 要 构造 
传统 的 URL， 则 可 以 使 用 url 属性 去 直接 构造 ， 例 如 : 

例 1: 


若 不 指定 controller， 则 使 用 当前 的 controller。 输 出 为 : 


例 2: 


输出 为 : 


修改 了 商品 列表 的 显示 效果 ， 还 需要 再 修改 显示 商品 明细 的 页 面 ， 只 需要 简单 地 修改 
一 下 显示 格式 即 可 。 将 grails-app\views\goods\show.gsp 文件 中 的 tbody 标签 的 内 容 修改 为 : 


显示 效果 如 图 4-5 所 示 。 


Grails 技术 精 解 与 Web 开发 实践 


例 Home 关 coodstist 国 New coods 


Show Goods 
Title; Grails 
Photo: 


Category: ”Book 
Description: Grails Book... 


Price: 20.00 


六 Edt [® Delete 


4-5 改进 后 的 商品 明细 页 面 


4.3 ”创建 和 编辑 商品 


这 里 暂时 完成 了 商品 列表 页 面 ， 下 面 去 处 理 商品 提交 的 表单 页 面 。 这 一 节 包 含 更 多 的 
知识 点 ， 主 要 有 : 表单 的 构造 、 表 单 的 接收 、 表 单 的 输出 。 

首先 打开 编辑 商品 的 页 面 'grails-app\views\goods\edit.gsp， 需 要 先 调整 一 下 几 个 字段 的 
顺序 (category、title、description、photoUrl、price)， 然 后 把 description 的 文本 框 蔡 换 为 
多 行 的 。 显 示 效 果 如 图 4-6 所 示 。 

这 里 仅 摘 录 表 单 相关 的 内 容 〈 完 整 的 代码 修改 情况 ， 读 者 可 以 参阅 本 书 附 带 光 盘 的 代 
人 码 .\grails-app\views\goods\edit.gsp): 


1 创建 商品 和 编辑 商品 在 逻辑 上 比较 相似 ， 因 而 这 里 仅 以 编辑 商品 为 例 。 


Edit Goods 
| Categoy: ER 


Title: 


Description: 


Photourl: Jhapi//otho.douban.cor 
Price: ‘20.0 


EE 


图 4-6 经 过 调整 后 的 编辑 商品 页 面 


从 上 面 的 代码 可 以 看 出 ，Grails 的 表单 同 标准 的 HIML 表单 几乎 是 完全 一 样 的 ， 换 句 
话说 , 读者 几乎 不 需要 去 学 习 和 记忆 Grails 自 带 的 表单 标签 ， 只 要 使 用 标准 的 HTML 标签 
就 够 了 (对 比 Struts 或 JSF， 这 是 很 大 的 优势 ， 毕 竞 学习 成 本 降低 了 )。 从 上 面 的 代码 还 能 
看 到 表单 输出 相关 的 知识 点 : 标准 的 HTML 表单 项 ， 只 需要 修改 value 属性 值 ( 这 里 有 个 
例外 是 textarea， 它 是 把 默认 值 写 到 <textarea></textarea> 中 间 去 ); 而 对 于 相对 复杂 的 下 拉 
列表 框 <select>，Grails 提供 的 g:select 标签 ， 也 可 以 使 用 value 属性 去 给 它 指定 默认 选中 
的 项 。 

<g:form> 标 签 是 本 节 的 第 一 个 知识 点 。 它 用 于 输出 一 个 传统 的 <form> 标 签 。g:form 的 


使 用 和 g:link 类 似 ， 支 持 用 controller、action、url 属性 去 构造 表单 接收 URL 的 地 址 ， 如 下 
面 的 一 些 示例 。 
例 4: 


输出 : 


| 


输出 : 


还 可 以 指定 表单 提交 的 method 及 enctype， 如 ; 


g:form 的 使 用 和 标准 的 HIML 的 form 非常 相似 。 使 用 它 的 主要 好 处 是 它 可 以 使 用 
controller 和 action 去 生成 url。 不 过 这 里 要 强调 一 点 ， 仅 通过 生成 form 的 action 不 能 唯一 
决定 最 终 的 表单 处 理 程序 。g:actionSubmit 标签 也 可 以 影响 最 终 由 哪个 controller 的 哪个 
action 处 理 表单 。 

<g:select> 是 第 二 个 知识 点 ， 这 是 一 个 非常 有 价值 的 标签 ， 因 为 使 用 它 要 比 使 用 传统 的 
HTML 的 select 要 简便 得 多 。g:select 有 一 个 必 填 的 from 属性 ， 这 个 属性 用 于 指定 其 选项 
的 数据 来 源 。 以 上 例 为 例 ，from="${Category.list0}" 表 示 用 Category.list0 的 返回 结果 作为 
数据 源 ， 即 下 拉 列 表 框 的 选项 是 Category 的 列表 ; optionKey="id" 表 示 依 次 用 数据 库 源 中 
每 个 Category 的 id 作 为 每 个 选项 的 值 ( 即 <option value=""> </option> 中 value 对 应 的 内 容 ); 
类 似 地 , opitonValue="categoryName" 表 示 依 次 用 数据 库 源 中 每 个 Category 的 categoryName 
作为 每 个 选项 的 显示 结果 (例如 <option >Book</option> 中 Book 对 应 的 内 容 )。 

value 属性 是 整个 g:select 最 有 价值 的 体现 ， 通 过 指定 value 属性 ，g:select 会 自动 选中 
当前 列表 中 与 value 等 值 的 选项 。 倘 若是 自己 来 手动 实现 这 个 功能 ， 恐 怕 就 要 在 遍历 选项 
的 时 候 逐 一 比较 了 ， 这 将 变 得 苦 不 堪 言 。 

g:actionSubmit 标签 可 以 输出 一 个 <input type="submit"/>。 它 有 一 个 很 强大 的 功能 ， 就 
是 指定 响应 按钮 的 action"， 相 当 于 给 不 同 的 按钮 指定 不 同 的 事件 处 理 程序 。 分 析 GSP 输出 
的 HTML 代码 : 


从 中 可 以 看 出 ,提交 表单 中 包含 了 name 为 _action XXX 的 input 项 (HTML 处 理 submit 
类 型 的 按钮 的 方式 是 ， 用 户 单 击 了 哪个 按钮 ， 就 会 提交 它 的 name 和 value)，Grails 会 根据 
这 个 _action XXX 后 面 的 XXX 去 选择 相应 的 action (XXX 是 首 字母 大 写 的 action 的 名 字 ， 
即 ， 要 运行 update， 则 应 写成 action Update)。 注 意 一 点 ， 这 里 之 所 以 说 的 是 表单 项 而 不 


是 按钮 ,是 因为 Web 框架 在 Server 端 ， 并 不 能 判断 哪个 数据 是 由 什么 形式 的 页 面 元 素 提交 
的 。 换 句 话 说， 在 页 面 中 添加 一 个 <input type="hidden" name="_action Update" value=""/>， 
然后 提交 ，Grails 一 样 也 会 根据 _action XXX 后 面 的 XXX 去 确定 由 哪个 action 处 理 表单 。 
Grails 的 这 一 设计 ， 也 为 程序 员 解 决 形 如 “根据 用 户 选择 的 下 拉 列 表 框 数据 ， 选 择 不 同 的 
action 进行 处 理 ” 这 样 的 需求 提供 了 便捷 。g:actionSubmit 可 以 用 action 属性 指定 接收 请 求 
的 action， 此 时 可 以 用 value 属性 指定 按钮 上 显示 的 文本 。 

GSP 页 面 (views) 中 的 表单 已 经 构造 完毕 ， 那 么 Controller 中 的 action 又 是 如 何 接收 
表单 数据 的 呢 ? 进入 GoodsController 的 update action: 


这 段 代码 实现 了 接收 表单 并 更 新 数据 库 中 的 记录 。 首 先 讨 论 如 何 接收 表单 。params 是 
用 于 获取 表单 数据 的 Map。 使 用 params.id 或 者 params["id']， 就 可 以 取得 name 为 id 的 表 
单项 的 值 。 

def goodsInstance = Goods.get( params.id )， 这 里 用 到 了 一 个 很 重要 的 Domain 方法 : 
get 方法 。get 可 以 实现 用 一 个 id 值 (主键 值 ), 去 获取 表 中 的 一 条 记录 , 在 取出 了 一 条 goods 
记录 后 ，goodsInstance.properties = params 可 以 把 Map 中 的 键 值 按照 同名 的 原则 赋值 给 
goods 对 象 。 如 params['category.id"] 的 值 ,会 赋 给 goodsInstance 的 category 属性 的 id 属性 。 
对 properties 属性 赋值 ， 确 实 可 以 极 大 地 帮助 程序 员 减 轻 由 表单 构造 对 象 的 工作 。 

由 于 Groovy 类 都 包含 使 用 Map 参数 初始 化 对 象 的 默认 构造 函数 ， 因 此 还 可 以 使 用 如 
下 代码 构造 对 象 : def goodsInstance =new Goods(params)!。 此 时 ，goodsInstance 的 内 容 已 经 
被 表单 数据 初始 化 了 。 

Domain 类 的 hasError 方法 可 以 检查 记录 是 否 符合 约束 条 件 , save 方法 可 以 实现 将 记录 
保存 到 数据 库 。 


1 从 语义 上 讲 ， 更 新 数据 库 中 的 数据 ， 不 应 该 使 用 new 创建 新 的 对 象 。 从 技术 角度 讲 ， 使 用 new 创 
建 的 对 象 不 存在 于 Hibernate 的 持久 化 上 下 文中 ， 因 而 无 法 实现 更 新 。Grails 中 推荐 的 更 新 数据 库 记 录 的 
作法 是 先 用 get 方 法 从 数据 库 读 取 数 据 ， 并 构造 domain 对 象 的 实例 ,然后 再 用 properties 属性 去 更 新 其 内 
容 。 读 者 不 必 过 分 担心 get 请 求 带 来 的 数据 查询 开销 ，Hibernate 的 缓存 机 制 可 以 解决 这 个 问题 。 关于 缓存 
的 介绍 ， 参 见 本 书 的 第 三 部 分 。 


Controller 的 redirect 方法 和 render 方法 都 用 于 显示 其 他 的 页 面 。 但 它们 有 本 质 的 区 别 : 
redirect 方法 相当 于 在 客户 端 执行 跳 转 ,会 发 起 新 的 HTTP 请 求 ; 而 render 方法 ,在 于 指定 
了 下 一 步 要 处 理 显 示人 逻辑 的 页 面 ， 在 客户 端 并 不 存 任何 跳 转 。redirect 方法 只 能 通过 ul 传 
递 简单 类 型 的 参数 数据 ， 而 render 方法 可 以 通过 model 传递 完整 的 数据 供 页 面 使 用 。 

flash 相当 于 是 Controller 中 提供 的 一 个 “通道 ?， 它 能 够 在 当前 HTTP 请 求 和 下 一 次 
HTTP 请 求 间 共享 数据 。 在 下 一 次 HITP 请 求 完 成 时 , 会 自动 清除 内 容 ，Grails 帮助 程序 员 
控制 了 它 的 完整 生命 周期 。 

GSP 页 面 中 可 以 直接 访问 flash， 显 示 flash.message 内 容 的 代码 如 下 : 


删除 商品 逻辑 更 加 简单 ，GoodsController 中 delete action 的 程序 代码 如 下 : 


一 句 话 概括 就 是 : 根据 id 取出 商品 ， 当 它 存在 时 ， 调 用 delete 方法 删除 记录 ， 不 存在 
时 利用 flash 报告 警告 信息 ， 最 后 ， 跳 转 到 list action 的 页 面 。 


4.4 本 章 小 结 


本 章 首先 创建 了 应 用 程序 并 完成 了 数据 库 的 配置 。 然 后 阅读 并 修改 了 Grails 自动 生成 
的 代码 ， 实 现 了 商品 列表 和 商品 维护 。 介 绍 了 数据 输出 、 数 据 遍 历 、 链 接 的 制作 ， 然 后 介 
绍 了 表单 构造 、 表 单 接收 、 表 单 输出 几 个 基本 技术 ， 同 时 还 介绍 了 少量 的 数据 库 相关 的 操 
作 (list 方法 、get 方法 、save 方法 、delete 方法 )。 下 面 的 章节 将 完成 一 些 不 能 由 Grails 自 
动 生成 的 功能 ， 以 进一步 学 习 Grails。 表 单 相关 的 还 有 一 个 重要 的 知识 点 是 表单 验证 ， 将 
在 第 6 章 进行 详细 的 介绍 。 

从 本 章 的 内 容 中 ， 读 者 还 可 以 体会 出 使 用 Grails 开发 的 一 个 特点 ， 就 是 先 用 Grails 自 
动 生成 脚手架 代码 ， 然 后 在 它 的 基础 上 进行 修改 ， 这 样 做 ， 不 但 开发 速度 快 ， 而 且 程序 质 


量 高 。 


这 是 
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为 了 让 顾客 能 够 快速 地 找到 他 想 要 的 商品 ， 提 供 一 个 商品 搜索 的 功能 是 十 分 必要 的 。 
希望 用 户 能 按照 商品 的 名 称 、 分 类 、 商 品 描述 以 及 价格 区 间 进 行 搜索 。 本 章 要 求 读者 


掌握 如 下 技能 ， 自 由 地 构造 表单 、 进 行 复杂 的 数据 库 查询 ( HibernateCriteriaBuilder)、 显 
示 分 页 导航 (g: paginate)。 


5.1 构造 查询 表单 


改 ， 
edit 


回顾 一 下 前 一 章 用 于 编辑 商品 的 表单 页 面 ， 是 在 Grails 自动 生成 的 edit 页 面 上 进行 修 
因此 很 快 就 能 完成 相应 工作 。 在 本 节 中 需要 搭建 一 个 用 于 搜索 的 页 面 ， 该 页 面 可 以 在 
页 面 上 进行 改造 。 首 先 ， 在 ..\views\goods\ 中 新 建 一 个 文件 searchForm.gsp， 把 edit.gsp 


的 代码 全 部 复制 过 来 。 然 后 ， 修 改 代码 如 下 (这 里 仍然 仅 包含 表单 相关 的 内 容 ， 完 整 的 代 
码 读者 可 以 参阅 本 书 附带 光盘 的 代码 .\grails-app\views\goods\searchForm.gsp): 


<g:form method="get" action="search" > 

Category: <g:select optionKey="categoryName" optionValue="categoryName" 

from="${ Category.list() }" name="categoryName" 
noSelection="${['':'']}" ></g:select> 

Title: <input type="text" id="title" name="title" /> 

Description: 

<textarea id="description" name="description"></textarea> 

Price: 
<input type="text" id="priceLow" name="priceLow" /> 

To: <input type="text" id="priceHigh" name="priceHigh" /> 


<input type="submit" class="save" value="Search" /> 
</g:form> 


giselect 的 optionKey 选择 了 categoryName 而 不 是 id, 是 为 了 增加 这 个 查询 的 实现 难度 ， 


因为 查询 categoryName 就 需要 对 数据 库 的 两 张 表 进行 联合 查询 。 读 者 只 有 掌握 了 能 解决 更 
复杂 问题 的 技术 ， 处 理 实际 问题 才能 更 得 心 应 手 。 


上 面 表单 页 面 中 的 新 知识 点 并 不 多 ， 只 要 注意 一 下 g:select 的 noSelection 属性 ， 它 的 


作 


是 : 当下 拉 列 表 框 没有 指定 默认 选项 或 指定 了 默认 选项 但 该 选项 不 存在 时 ， 选 中 下 拉 


列表 框 的 默认 选项 。noSelection="${[":"]}" 相 当 于 加 入 了 值 和 显示 都 为 空 字 符 串 ("") 的 
选项 。 

由 于 当前 GSP 页 面 仅 用 于 输出 一 个 查询 表单 ， 并 不 需要 Controller 提供 数据 ， 因 此 只 
需要 在 GoodsController 中 放 一 个 空 的 searchForm action 即 可 : 


运行 程序 并 访问 http://localhost:8080/GDepot/goods/searchForm， 会 看 到 如 图 5-1 所 示 
的 搜索 页 面 。 


图 5-1 搜索 商品 的 表单 


5.2 ”复杂 的 数据 库 查 询 


只 用 了 很 短 的 时 间 , 就 设计 好 了 用 于 查询 的 表单 页 面 , 但 这 里 的 查询 逻辑 却 并 不 简单 : 
category 字段 ， 如 果 选 择 了 非 空 ， 则 需要 连接 Category 表 ， 并 用 该 字段 进行 比较 ;title 和 
description 字段 ， 如 果 不 为 空 ， 需 要 用 like 语句 进行 判断 ; priceLow 和 priceHigh 分 别 指定 
价格 的 下 限 和 上 限 ， 也 是 仅 在 其 值 不 为 空 的 时 候 有 效 …… 

需求 的 提出 很 自然 , 但 解决 起 来 却 并 不 简单 。 如 果 用 传统 的 字符 串 拼 SQL 语句 的 做 法 ， 
可 以 想象 一 下 , 由 于 每 个 条 件 都 不 是 必 填 的 , 仅仅 判断 该 项 是 否 需要 对 应 的 where 子 语句 ， 
拼接 的 逻辑 就 会 非常 复杂 ， 更 何况 category 还 会 决定 是 否 要 连接 另外 一 张 数 据 库 表 。 

考虑 到 本 节 的 代码 可 能 需要 反复 调试 ， 如 果 不 希 望 在 实际 的 页 面 上 测试 查询 的 逻辑 ， 


可 以 使 用 Grails 的 控制 台 。 相 信 读 者 不 会 忘记 Groovy 的 控制 台 ， 那 是 一 个 非常 实用 的 
Groovy 程序 运行 接口 ， 在 其 中 调试 简单 的 代码 是 非常 愉快 的 。 在 Grails 中 同样 可 以 使 用 控 
制 台 。 在 命令 行 输入 grails console 命令 即 可 启动 Grails 的 控制 台 ， 如 图 5-2 所 示 。 


EC 


5-2 ”Grails 中 的 GroovyConsole 


本 节 编 写 的 数据 库 查询 的 代码 ， 推 荐 在 控制 台 上 运行 并 调试 。 不 过 ， 不 要 忘 了 存盘 ， 
不 然 修 改 Domain 类 等 操作 可 能 会 导致 控制 台 自 动 重启 而 丢失 代码 。 


5.2.1 HibernateCriteriaBuilder 的 初 窥 


针对 这 样 复杂 的 查询 问题 , Hibernate 给 程序 员 提 供 了 很 好 的 方案 , 那 就 是 构建 Criteria 
查询 。 它 可 以 以 一 种 很 优雅 的 方式 拼接 出 很 复杂 的 查询 逻辑 。 更 加 幸运 的 是 ，Grails 又 对 
Hibemate 的 Criteria 查询 进行 了 更 优雅 的 封装 ，Grails 为 它 提供 的 组 件 名 为 
HibernateCriteriaBuilder。 

这 里 修改 GoodsController 的 代码 ， 加 入 一 个 search action， 如 下 所 示 : 


这 部 分 代码 对 于 读者 来 说 ， 是 全 新 的 知识 点 ， 数 据 库 的 查询 采用 了 Grails 的 Hibemate 
CriteriaBuilder。 首 先 用 Goods.createCriteria() 创 建 了 一 个 针对 Goods 的 Criteria 查询 。 然 后 
将 一 个 描述 查询 逻辑 的 闭 包 传 给 它 的 list 方法 ， 便 实现 了 查询 。 而 这 个 闭 包 的 代码 是 十 分 
优雅 的 ， 例 如 : 


这 段 代 码 表 示 ， 当 表单 提交 的 参数 “categoryName” 不 为 空 字符 串 (") 时 ， 与 category 
表 进 行 关联 , 并 加 入 查询 条 件 :category 表 的 categoryName 要 与 params.categroyName 相等 。 

类 似 地 , if (params.title) {Zike(witley"968tparamas.tiz1e8% 几 } 表 示 当 paramsstitle 不 为 空 
时 ， 加 入 查询 条 件 : goods 表 的 title 字段 like "%$fparams.title2% "1。 

同 理 ，ge(price'new BigDecimal (params.priceLow)) 和 le('price'new BigDecimal 
(params.priceHigh)) 表 示 加 入 price 要 大 于 等 于 params.priceLow 和 price 要 小 于 等 于 
params.priceHigh。 

理解 了 上 面 的 代码 ,相信 读者 一 定 会 被 Grails 的 HibernateCriteriaBuilder 的 优雅 所 感动 。 


1 这 里 要 用 SQL 语句 的 like， 用 于 模糊 查询 ，% 表 示 通 配 符 。 


HibemateCriteriaBuilder 相当 于 是 一 种 进行 数据 库 查 询 的 DSL。 显 然 ， 使 用 DSL 可 以 更 加 
优雅 和 轻松 地 完成 原本 复杂 的 任务 。 接 下 来 对 HibemateCriteriaBuilder 的 使 用 作 更 详细 的 
介绍 ， 表 5-1 包含 了 在 Criteria 中 可 用 的 方法 (用 于 编写 查询 条 件 )。 


isEmpty 
isNotEmpty 
isNull 
isNotNull 

lt 
ltProperty 
le 


leProperty 


like 


sizeEq 


默认 的 情况 下 ， 查 询 条 件 之 间 的 关系 是 “与 ”的 关系 ， 可 以 通过 or、not 实现 复杂 的 
逻辑 关系 ， 如 下 例 所 示 : 


表 5-1 Criteria 中 可 用 的 查询 方法 


约束 属性 的 值 在 给 定 的 值 之 间 

约束 属性 的 值 等 于 特定 的 值 

约束 某 一 属性 必须 等 于 另 一 属性 
约束 属性 的 值 大 于 特定 的 值 

约束 某 一 属性 必须 大 于 另 一 属性 
约束 属性 的 值 大 于 或 等 于 特定 的 值 
约束 某 一 属性 必须 大 于 或 等 于 另 一 
属性 

约束 某 一 对 象 的 id 等 于 给 定 的 值 

大 小 写 敏 感 的 ilike 查询 

约束 某 一 属性 被 包含 于 给 定 的 list 值 中 
( 注 : in 是 groovy 的 保留 字 ， 使 用 时 
需要 加 引号 ) 

约束 属性 的 集合 为 空 

约束 属性 的 集合 不 为 空 
约束 属性 的 值 为 Null 

约束 属性 的 值 不 为 Null 

约束 属性 的 值 小 于 特定 的 值 

约束 某 一 属性 必须 小 于 另 一 属性 
约束 属性 的 值 小 于 或 等 于 特定 的 值 
约束 某 一 属性 必须 小 于 或 等 于 另 一 
属性 

等 同 于 SQL 里 的 like 查询 〈 大 小 写 不 
敏感 ) 

约束 属性 的 值 不 等 于 特定 的 值 

约束 某 一 属性 不 等 于 另 一 属性 

按照 某 一 特定 属性 来 给 查询 结果 排序 
约束 属性 集合 的 大 小 等 于 特定 的 值 


between("balance" 500. 1000) 

eq("branch", "London ) 
eqProperty("lastTransaction", "firstTransaction") 
gt("balance".1000) 
gtProperty("balance","overdraft") 
ge("balance".1000) 
geProperty("balance","overdraft") 


idEq(1) 
ilike("holderFirstName","Steph%6") 
‘in'("holderAge".[18..65]) 


isEmpty("transactions") 
isNotEmpty("transactions") 
isNull("holderGender") 
isNotNull(“holderGender") 
lt("balance",1000) 
ltProperty("balance"."overdraft") 
le("balance".1000) 
leProperty("balance"."overdraft") 


like("holderFirstName"."Stepho6") 


ne("branch". "London") 
neProperty("lastTransaction". "firstTransaction") 
order("holderLastName", "desc") 
sizeEq("transactions". 10) 


等 价 于 如 下 的 查询 逻辑 : 


5.2.2 ”数据 库 的 分 页 查询 


接 下 来 回 到 之 前 的 查询 代码 中 ， 会 发 现 还 有 一 些 问 题 没 有 解决 。 通 常情 况 下 ， 不 能 将 
全 部 查询 结果 直接 返回 到 页 面 ， 因 为 有 可 能 一 次 查询 就 产生 非常 海量 的 数据 ， 若 全 部 输出 
页 面 ， 一 方面 页 面 数据 过 多 对 用 户 也 并 不 友好 ， 另 一 方面 将 给 服务 器 带 来 较 大 的 负荷 。 
此 ， 分 页 的 数据 库 查 询 和 分 页 的 显示 输出 是 必 不 可 少 的 需求 。 

提 到 分 页 的 功能 ， 实 际 上 有 两 件 事情 要 做 : 一 件 事情 是 要 进行 分 页 的 查询 ， 另 一 件 事 
情 是 在 页 面 显示 时 能 提供 一 个 可 以 在 不 同 页 切换 的 分 页 导航 。 

要 实现 分 页 查询 ，HibernateCriteriaBuilder 提供 了 多 种 实现 方法 。 在 闭 包 中 ， 可 以 使 用 
maxResults() 和 firstResult0 方 法 去 控制 分 页 的 查询 ， 具 体操 作 过 程 如 下 : 


但 是 事情 还 没有 完 , 由 于 分 页 后 还 要 在 页 面 上 显示 总 页 数 的 信息 , 还 需要 查询 数据 库 ， 
以 计算 出 符合 条 件 的 数据 总 数 。 如 果 使 用 传统 的 SQL 语句 来 实现 , 相信 读者 一 定 会 想到 用 
count0 函 数 去 实现 。 在 HibemateCriteriaBuilder 中 ， 也 可 以 使 用 count， 有 具体 做 法 如 下 : 


这 里 c.get 表示 只 保留 查询 返回 的 第 一 条 记录 。 projections 表示 要 进行 组 查询 (group by 
语句 )。 在 projections 中 调用 properties 方法 可 以 指定 SQL 中 要 group by 的 字段 , 使 用 max、 
min、avg、count、sum 等 函数 则 可 以 查询 某 一 字段 的 最 大 、 最 小 、 平 均 、 个 数 、 求 和 等 
的 值 。 

功能 是 已 经 完成 了 ， 但 是 坏 味道 (bad smell) 已 经 出 现 了 。 两 个 查询 的 逻辑 是 何等 相 
似 ， 但 为 何 要 写 两 遍 呢 ? 重复 代码 出 现 了 ， 这 不 是 个 好 现象 。 

事实 上 ，HibernateCriteriaBuilder 还 提供 了 count 方法 ,可 以 实现 取 查 询 结果 总 数 '。 而 
且 这 个 count 方法, 会 自动 忽略 查询 闭 包 中 指定 的 maxResults 和 firstResult, 这 样 就 为 闭 包 
重用 提供 了 可 能 。 现 在 只 要 将 代码 改造 为 如 下 模样 : 


1 count 方 法 在 官方 的 网 站 中 并 没有 给 出 ,笔者 通过 阅读 HibemateCriteriaBuilder 的 源 代码 掌握 了 该 点 。 
感 兴趣 的 读者 可 以 在 最 后 一 部 分 ， 对 HibemateCriteriaBuilder 的 源码 进行 讨论 。 


此 时 , 将 查询 逻辑 提取 出 来 , 取 名 为 searchClosure, 然后 分 别 用 HibernateCriteriaBuilder 
的 list 方法 和 count 方法 对 数据 库 进行 查询 。 这样 便 有 了 一 个 已 分 页 的 goods 列表 和 全 部 符 
合 条 件 的 goods 总 数 。 

现在 的 代码 已 经 比较 优雅 了 ， 但 情况 还 可 以 向 更 好 的 方向 继续 发 展 。HibernateCriteria 
Builder 的 list 方法， 本身 就 支持 分 页 !。 回 顾 一 下 前 一 章 介 绍 的 list 方法 : Goods.list 
(params) 可 以 实现 根据 params 里 的 max 和 offset 参数 去 控制 分 页 查询 ， 此 外 ， 若 Map 中 还 
包含 sort 和 order， 则 还 可 以 实现 控制 查询 时 的 排序 (sort 用 于 指定 排序 字段 ，order 用 于 
指定 是 升序 排序 asc 还 降序 排序 desc)。HibernateCriteriaBuilder 的 list 方法 ， 也 支持 分 页 
Map。 可 以 进一步 把 search 的 代码 改写 为 如 下 : 


! 这 一 点 官方 网 站 中 也 没有 给 出 ， 作 者 是 通过 阅读 源 代码 掌握 的 。 


当 调用 HibernateCriteriaBuilder 的 list 方法 时 , 如 果 传 入 两 个 参数 , 且 一 个 参数 是 Map， 
则 该 list 方法 将 进行 分 页 查询 。 单 页 的 大 小 (maxResults) 和 第 一 条 记录 位 置 (firstResult) 
分 别 由 Map 的 max 和 offset 两 个 key 来 指定 。 

此 时 返回 的 goods 也 不 再 是 简单 的 List 类 型 ， 而 是 由 Grails 提供 的 grails.orm.Paged 
ResultList 类 的 实例 。 这 个 类 也 实现 了 javautiLList 接口 ， 除 了 拥有 List 的 全 部 特征 之 外 ， 
还 多 了 一 个 totalCount 属性 。 这 个 属性 的 值 就 符合 查询 条 件 的 记录 总 数 :。 

如 果 希 望 了 解 查 询 逻 辑 被 转换 成 了 什么 样 的 SQL 语句 〈 不 过 大 可 不 必 担 心 Hibemate 
生成 SQL 有 错误 ， 毕 竟 这 是 全 世界 开源 爱好 者 监督 下 的 最 成 熟 的 项 目 )， 可 以 通过 配置 查 
看 SQL 的 log?。 

修改 数据 源 的 配置 文件 (grails-app\conf\DataSource.groovy)， 在 dataSource 节点 中 加 
入 logSql= truae， 如 以 下 代码 中 的 黑 斜 体 所 示 : 


然后 重新 启动 Grails， 再 次 执行 查询 ， 就 可 以 在 控制 台 上 看 到 Hibernate 生成 的 SQL 
了 “下面 的 SQL 是 在 所 有 查询 条 件 都 不 为 空 的 情况 下 产生 的 ): 


1 从 源 代码 里 可 以 看 到 ， 记 录 总 数 的 查询 过 程 与 之 前 介绍 的 count 方法 比较 相似 。 
? 如 果 是 Grails 的 控制 台 调 试 查询 代码 ， 开 启 了 logSql 后 ， 可 以 直接 在 控制 台 的 输出 中 看 到 SQL 语 
句 ， 非 常 方便 实用 。 


从 上 面 的 SQL 的 log 可 以 看 到 ，Grails 一 共 执行 了 两 个 SQL: 用 select count(*) 查 询 了 
记录 总 数 ， 用 “limit ?” 对 单 页 记录 的 数目 进行 限制 :， 从 而 实现 了 分 页 的 查询 。 从 生成 的 


! 不 同 的 数据 库 ， 实 现 分 页 所 需 的 SQL 语句 是 不 一 样 的 。Hibemate 在 生成 SQL 时 ， 屏 蔽 了 这 一 层 的 
区 别 ， 使 得 程序 员 能 够 以 一 种 统一 的 方式 ， 对 不 同 的 数据 库 进行 分 页 查询 。 


SQL 中 可 以 看 到 ,默认 的 情况 下 ,是 对 goods 表 和 category 表 进行 了 外 连接 操作 (left outer join )。 
Hibernate 生成 的 SQL 默认 使 用 外 连接 有 它 自 身 的 道理 , 因为 这 里 是 对 goods 进行 查询 ， 
如 果 不 使 用 外 连接 ， 那 么 就 会 导致 category 为 空 的 goods 将 永远 不 会 被 取出 。 


5.2.3 ”将 查询 改造 为 inner join 


虽然 使 用 外 连接 有 它 的 道理 ， 但 出 于 灵活 考虑 ， 不 用 外 连接 的 情况 也 需要 支持 。 可 以 
通过 调用 fetchMode 方法 ， 设 置 对 其 他 表 抓 取 模式 为 主动 抓 取 ， 从 而 实现 主动 连接 其 他 表 ， 


例如 : 


其 中 的 FetchMode 类 是 Hibermate 提供 的 一 个 类 ， 需 要 导入 才能 使 用 (import 
org.hibernate.FetchMode )。 
此 时 还 需要 编写 查询 条 件 ， 但 实践 证 明 ， 如 下 写法 并 不 能 正常 工作 : 


Hibernate 自动 生成 的 SQL 语句 ,会 给 category 起 比较 奇怪 的 别名 (category al ), 因 
此 需要 自己 指定 别名 , 才能 给 category 表 的 字段 设置 查询 条 件 。Criteria 类 提供 了 一 个 设置 
别名 的 方法 〈createAlias)， 用 于 为 关联 查询 的 表 设 定 别名 。 

事实 上 , HibernateCriteriaBuilder 的 查询 闭 包 中 可 以 直接 调用 Criteria 对 象 的 成 员 方法 ， 
前 面 调用 的 maxResults 和 firstResult 方法 ， 实 际 上 就 是 调用 了 Criteria 类 的 setMaxResults 
和 setFirstResult 方法 。 因 而 ， 可 以 调用 createAlias 方法 ， 为 连接 的 category 表 设 定 一 个 别 
名 ， 然 后 再 用 别名 进行 查询 : 


其 中 的 c.categoryName 就 体现 了 用 category 的 别名 e 访问 其 属性 categoryName。 此 时 
日 志 中 记录 的 SQL 语句 就 变 成 了 如 下 样式 : 


从 生成 的 SQL 可 以 看 出 ，left outer join 变 成 了 inner join， 并 且 category 表 使 用 了 别名 
cl _〈 显 然 和 指定 的 ec 有 关系 )。 

数据 库 的 查询 到 这 里 就 算 告 一 段落 了 ， 但 显示 查询 结果 的 页 面 还 有 一 些 工 作 ， 接 下 来 
就 去 修改 显示 查询 结果 的 页 面 。 


5.3 ”显示 分 页 导航 


在 search action 中 编写 了 查询 数据 库 的 程序 , 并 且 指 定 了 使 用 list.gsp 去 显示 搜索 结果 。 
就 搜索 结果 而 言 ，list.gsp 并 不 需要 做 改动 ， 因 为 search action 向 list.gsp 传递 数据 时 使 用 了 
与 list action 一 致 的 数据 接口 : Map 的 key 都 是 goodsInstanceList。 但 是 ， 用 于 分 页 导航 的 
标签 还 需要 修改 。 


Grails 提供 了 一 个 用 于 显示 分 页 导航 的 标签 :“g: paginate”。 这 个 标签 会 输出 一 系列 的 
链接 ， 有 “上 页 ”“ 下 页 ” 以 及 具体 某 一 页 ， 如 “1”“2”… 使 用 paginate 标签 可 以 使 用 
以 下 一 系列 属性 。 

(1) total ( 必 填 ) 一 一 数据 记录 总 数 , 用 于 计算 分 页 页 数 (相当 于 上 一 节 的 totalCount)。 

(2) action 〈 可 选 ) 一 一 指定 链接 指向 的 action， 默 认为 当前 action (参考 g:link)。 

(3)controller( 可 选 ) 一 一 指定 链接 指向 的 controller, 默认 为 当前 controller( 参 考 g:link )。 

(4) id (可 选 ) 一 一 指定 链接 的 id (参考 glink)。 

(5) params( 可 选 ) 一 一 包含 请 求 参数 的 Map (参考 g:link)。 

(6) prev (可 选 ) 一 一 显示 “上 页 ”按钮 的 文本 , 默认 使 用 messages.properties 的 default. 
paginate.prev 项 (关于 资源 文件 及 i18n 的 知识 ， 可 以 参考 第 6 章 )。 

(7) next (可 选 ) 显示 “下 页 ”按钮 的 文本 , 默认 使 用 messages.properties 的 default. 
paginate.next 项 。 

(8) max (可 选 ) 一 一 单 页 记录 的 最 大 值 ， 默 认为 10。 仅 在 params.max 为 空 时 有 效 。 

(9) maxsteps (可 选 ) 一 一 最 多 在 导航 中 显示 多 少 页 , 默认 为 10。 仅 在 params.maxsteps 
为 空 时 有 效 。 

(10) offset (可 选 ) 一 一 指定 链接 的 offset (从 第 几 条 数据 开始 显示 ), 仅 在 params.offset 
为 空 时 有 效 。 

修改 list.gsp 的 paginate 标签 ， 将 其 从 : 


修改 为 : 


关于 goodsInstanceListtotalCount ， 上 一 节 已 经 作 了 解释 。goodsInstanceList 是 
grails.orm.PagedResultList 类 的 实例 ， 通 过 它 的 totalCount 属性 ， 就 能 得 到 符合 查询 条 件 的 
数据 记录 的 总 数 。 

为 了 让 paginate 生成 的 导航 链接 能 够 继续 按照 当前 的 查询 条 件 进 行 查询 ， 需 要 用 当前 
页 面 params 设置 g:paginate 的 params 属性 的 值 。 

已 经 接近 成 功 了 ， 不 过 这 样 的 代码 还 存在 一 个 小 问题 ，list.gsp 原本 是 list action 的 显 
示 页 面 ， list action 向 页 面 传递 的 goodsInstanceList 是 由 Goods.list(params) 方 法 返回 的 , 并 
不 是 grails.orm.PagedResultList 类 的 实例 。 所 以 还 需要 对 GoodsController 的 list action 进行 
简单 的 修改 ， 让 它 返 回 PagedResultList。 代 码 修改 情况 为 : 


到 这 里 总 算 大 功 告 成 了 ， 可 以 享受 一 下 劳动 成 果 了 。 运 行 命令 : 
asmapp 


Grails 技术 精 解 与 Web 开发 实践 


然后 访问 http://localhost:8080/GDepot/goods/searchForm (由 于 开发 阶段 只 有 两 条 数据 ， 
为 了 方便 调试 ， 将 search action 中 的 params.max 设 为 了 1， 此 时 一 页 只 会 显示 一 条 数据 ， 
就 可 以 看 到 分 页 和 分 页 导航 的 效果 了 ， 如 图 5-3 所 示 )。 


文件 昌 纺 纺 日 坦 看 历史 (9) 书 答 @ 工具 四 和 动 
-CC 合 网 ( @ htpy/localhost8080/GDepoVgoods/search?categomName=atie=&description=&pricel=&price2= 
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5-3 ”查询 结果 


5.4 ”本 章 小 结 


本 章 实现 了 商品 搜索 的 功能 ， 着 重地 介绍 了 如 何 使 用 HibernateCriteriaBuilder 进行 复 
杂 的 数据 库 查询 ， 包 括 查 询 逻 辑 的 组 合 拼接 、 组 查询 、 分 页 查询 等 。 相 信 读 者 掌握 了 
HibernateCriteriaBuilder 技术 后 ， 再 去 处 理 一 般 的 数据 库 查 询问 题 将 会 得 心 应 手 。 

本 章 的 最 后 一 节 介绍 了 通过 g:paginate 标签 实现 在 页 面 上 输出 分 页 导航 链接 的 方法 。 
读者 在 学 习 了 本 章 后 ， 应 该 能 够 对 一 般 性 的 “数据 库 查询 + 分 页 ”问题 拿 出 一 个 比较 有 效 
的 实现 方案 了 。 


用 户 注册 与 登录 


“Os 


上 一 章 实现 了 商品 的 搜索 。 本 章 将 实现 用 户 注册 与 登录 。 本 章 的 知识 点 包括 : 表单 验 


证 、il8n 资源 文件 、Session 的 使 用 、filter 类 的 使 用 。 


6.1 表单 验证 与 资源 文件 


要 实现 用 户 的 注册 与 登录 ， 首 先 要 设计 存储 用 户 信息 的 Domain 类 。 用 grails 


create-domain-class 命令 创建 一 个 User Domain: 
>grails create-domain-class User 
然后 修改 User.groovy 的 代码 如 下 : 


class User { 

String userName 

String password 

String email 

String phone 

String address 

static constraints = { 
userName (size:2..10,blank:false) 
password(size:6..30,blank:false) 
email (email:true,unique:true,blank:false) 
phone (matches:/\d{7,11}/,blank:false) 
address (maxSize:200,blank:false) 


} 
User 类 中 除了 基本 的 字段 属性 ， 还 包含 了 一 个 static 的 constraints 闭 包 ， 


其 实在 第 4 


章 商品 维护 中 就 见 过 这 样 的 闭 包 。 它 在 Grails 的 Domain 中 用 于 描述 数据 约束 。 通 过 
constraints， 可 以 实现 对 数据 的 有 效 性 进行 检查 ， 进 而 实现 对 表单 数据 的 验证 。Grails 中 的 


constraints 可 以 理解 为 一 种 进行 数据 约束 的 DSL。 
对 于 User 类 ， 这 里 限制 它 : 
(1) userName 属性 不 能 为 空 值 ， 字 符 串 长 度 为 2 一 20; 
(2) password 属性 不 能 为 空 值 ， 字 符 串 长 度 为 6 一 30; 


(3) email 属性 不 能 为 空 值 ， 格 式 要 符合 E-mail 的 要 求 ， 而 且 在 数据 库 中 不 能 重复 ; 
(4) phone 属性 不 能 为 空 值 ， 由 7 一 11 位 数字 组 成 ; 
(5) address 属性 不 能 为 空 值 ， 长 度 不 超过 200。 
理解 了 User 类 的 约束 条 件 , 读者 将 发 现 Grails 的 约束 描述 非常 简单 和 强大 ， 只 需要 按 
照 如 下 格式 编写 : 


Grails 中 常用 的 约束 条 件 如 表 6-1 所 示 。 
表 6-1 Grails 的 数据 约束 条 件 


blank 


用 于 验证 String 的 值 是 否 为 空 


creditCard ”用 于 验证 String 的 值 是 不 是 有 效 


inList 


matches 


的 信用 卡号 码 ， 内 部 调用 the org. 
apache.commons.validator.Credit 
CardValidator 类 

用 于 验证 String 的 值 是 不 是 有 效 
的 E-mail 地 址 ， 内 部 调用 org. 
apache.commons.validator. 
EmailValidator 类 

用 于 验证 String 的 值 是 否 在 一 个 
范围 或 一 个 集合 中 


用 于 验证 String 的 值 是 否 符合 给 
定 的 正则 表达 式 

确保 一 个 值 不 超过 给 定 的 最 大 值 
确保 一 个 值 的 范围 不 超过 给 定 的 
最 大 值 

确保 一 个 值 不 小 于 给 定 的 最 小 值 
确保 一 个 值 的 范围 不 小 于 给 定 的 
最 小 值 

确保 属性 的 值 不 等 于 给 定 的 值 
当 把 nullable 设置 为 false 时 ， 确 


保 属性 的 值 不 能 为 null 
确保 属性 的 值 出 现在 给 定 的 范 
围 中 


login(blank:false) 

设 为 false 时 ，login 的 值 不 
能 为 空 
cardNumber(creditCard:true) 
设 为 tme 时 , cardNumber 应 
该 是 一 个 有 效 的 信用 卡号 码 


homeEmail(email:true) 
设 为 true 时 ，homeEmail 应 
该 是 一 个 有 效 的 E-mail 地 址 


name(inList:["Joe", 
"Bob"] ) 

约束 name 的 值 在 给 定 的 列 
表 里 


"Fred", 


login(matches:"[a-zA-Z]+") 
login 的 值 需要 符合 正则 表 
达 式 [a-zA-Z]+ 的 条 件 
age(max:new Date()) 
Price(max:999F) 
children(maxSize:25) 


age(min:new Date()) 
price(min:OF) 
children(minSize:25) 
login(notEqual:"Bob") 
age(nullable:false) 


age(range:18..65) 


className.property 
Name.blank 


className.property 
Name.creditCard.invalid 


className.property 
Name.email.invalid 


className.property 
Name.not.inList 


className.property 
Name.matches.invalid 


className.property 
Name.max.exceeded 
className.property 
Name.maxSize.exceeded 
className.property 
Name.min.notmet 
className.property 
Name.minSize.notmet 
className.property 
Name.notEqual 
className.property 
Name.nullable 
className.property 
Name range.toosmall or 


className.property 
Name range.toobig 


scale 给 浮 点 数 设置 需要 的 刻度 , 如 设置 ”salary(scale:2) 
小 数 点 右边 的 位 数 

size 约束 一 个 集合 , 一 个 数 或 一 个 字符 ”children(size:5..15) 
串 长 度 的 大 小 范围 


unique 约束 一 个 属性 在 数据 库 里 是 唯 ”login(unique:true)， 


一 的 group(unique:'department’), 
lopinlinigue:E Broup 
ul 用 于 验证 一 个 字符 串 的 值 是 否 为 ”homePage(url:true) 
有 效 的 URL 
validator 。 用 于 给 某 一 属性 添加 自 定义 的 验 
证 器 


续 表 


className.property 
Name.size .toobig 


className.property 
Name.unique 


className.property 
Name.urlinvalid 


表 6-1 的 最 后 一 列 是 错误 代码 ， 当 验证 发 生 错 误 时 , 可 以 根据 错误 代码 输出 错误 信息 。 
通过 错误 代码 与 资源 文件 的 绑 定 ， 可 以 从 中 选择 多 国语 言 的 错误 描述 。 


接 下 来 使 用 grails generate-all 命令 生成 User 的 CRUD 页 面 : 


用 户 注册 本 质 上 也 是 在 创建 用 户 ， 因 此 可 以 在 Grails 生成 的 create 页 面 基础 上 进行 修 
改 。 读 者 通过 create 页 面 可 以 体验 一 下 constraints 的 实际 效果 ， 首 先 运 行 run-app 命令 : 


| 
然后 访问 链接 http://localhost:8080/GDepot/user/create， 随 便 填 入 一 些 用 户 信 息 后 单 击 


create 按钮 ， 可 以 看 到 如 图 6-1 所 示 的 效果 。 


Create User 
加 [dass Userjs 和 属性 [address] 不 能 为 空 
加 [dass User] 类 的 属性 [email 和 3 值 [email] 不 是 一 个 合法 所 子 邮件 地 址 
User] 类 的 属性 [password 区 9 值 [1234 芍 9 大 小 不 在 合法 8 范围 内 ( [6] ~ [30] ) 
加 [dass User] 类 的 属性 [phone] 不 能 为 空 
加 [dass User] 类 的 属性 [userNameJ 不 能 为 空 


We Ts===ss 
二 ca 
me [OOo 


nn === 二 


图 6-1 默认 页 面 的 错误 显示 效果 


阅读 Grails 生成 的 代码 ， 可 以 帮助 读者 理解 验证 的 执行 过 程 。 打 开 UserController 的 
save action， 相 信 这 一 行 代码 一 定 会 引起 读者 的 注意 〈 粗 体 + 斜体 的 那 行 ): 


每 个 Domain 类 中 都 包含 一 个 用 于 记录 错误 信息 的 errors 属性 。userInstance.hasErrorsO) 
方法 用 于 检查 当前 的 user 是 否 已 经 包含 错误 。 此 时 的 错误 通常 是 表单 提交 时 产生 的 类 型 转 
换 错 误 ， 例 如 将 页 面 上 提交 的 字符 串 转换 为 日 期 类 型 ， 而 这 一 转换 可 能 因 格 式 的 不 匹配 而 
导致 失败 。 当 userInstance.hasErrors0 返 回 了 假 的 时 候 ，userInstance.save0 会 被 执行 。 前 面 
说 过 ，save 方法 是 用 于 保存 数据 的 ， 但 它 在 保存 之 前 ， 会 先 调用 validate 方法 进行 数据 校 
验 。 若 校 验 失败 ， 则 返回 null。 

因此 ， 用 两 句 话 总 结 Controller 中 进行 表单 校 验 的 逻辑 就 是 ， 先 调用 hasErrors 方法 ， 
检查 errors 属性 是 否 不 包含 错误 ， 然 后 调用 validate 方法 ， 进 行 校 验 ;倘若 该 Domain 实例 
需要 存 入 数据 库 ， 则 无 需 调 用 validate 方法 ， 直 接 调用 save 方法 并 判断 返回 值 不 为 null 
即 可 。 

Controller 中 实现 对 Domain 的 验证 ，GSP 就 要 实现 对 错误 信息 进行 输出 。 从 图 6-1 中 
可 以 看 到 Grails 自动 生成 的 页 面 是 以 两 种 方式 输出 错误 信息 的 : 一 种 是 将 全 部 错误 统一 输 
出 成 一 个 错误 列表 ; 另 一 方式 是 判断 或 输出 某 一 个 属性 的 错误 信息 。 


上 面 的 代码 实现 输出 错误 列表 。 其 中 g:hasErrors 标签 的 功能 与 Domain 的 hasErrors() 
方法 类 似 ， 当 bean 属性 值 user 有 错误 时 ， 才 执行 标签 内 部 的 代码 。g:renderErrors 标签 用 
于 输出 错误 信息 的 内 容 ，as="list" 表 示 以 <ul><li></li></ul> 的 方式 输出 列表 。 如 果 想 只 输出 
某 一 属性 的 错误 信息 ， 则 使 用 field 属性 ， 如 field="userName"， 表 示 只 输出 userName 属性 
相关 的 错误 。 当 前 g:renderErrors 的 as 属性 只 支持 list 一 种 风格 的 显示 效果 , 如 果 想 要 自己 
控制 输出 效果 ， 则 可 以 使 用 g:eachError 标签 。g:eachError 的 使 用 与 g:each 类 似 ， 但 仅 用 于 
遍历 对 象 中 的 错误 信息 ， 取 出 错误 信息 后 ， 可 以 由 用 户 自己 决定 如 何 输出 ， 例 如 : 


g:hasErrors、g:renderErrors、g:eachError 还 可 以 一 次 处 理 多 个 对 象 。 将 多 个 需要 处 理 的 
对 象 组 装 成 一 个 Map， 然 后 将 它 传 递 给 model 属性 。 


此 时 的 标签 会 同时 检查 book 和 cmd 两 个 对 象 ， 看 是 否 都 没有 错误 。 
Grails 生成 的 页 面 中 将 内 容 有 误 的 输入 项 用 红 框 轿 了 起 来 。 这 一 点 实现 起 来 很 简单 ， 
原理 上 是 先 判断 这 个 属性 是 否 有 误 , 如 果 有 , 则 对 它 所 在 的 单元 格 使 用 显示 有 误 内 容 的 CSS 


相信 读者 现在 已 经 理解 ， 验 证 数据 和 显示 错误 的 程序 代码 了 。 但 是 ， 如 何 订 制 对 不 同 
错误 显示 不 同 的 信息 呢 ? 

用 资源 文件 可 以 完美 地 解决 这 个 问题 。 回 忆 一 下 2.2 节 ，grails-app\il8n 文件 夹 中 存放 
了 针对 不 同 语言 的 资源 文件 。Grails 会 自动 根据 当前 的 请 求 〈 客 户 端 系统 使 用 的 语言 )， 选 
择 对 应 的 资源 文件 ,从 而 就 实现 了 国际 化 的 支持 。 而 这 与 报错 信息 有 没有 关系 呢 ? 有 关系 ， 
回忆 一 下 表 6-1 的 内 容 , 每 个 约束 条 件 都 对 应 一 个 错误 代码 。 在 显示 错误 信息 的 时 候 , Grails 
就 是 根据 这 个 错误 代码 ， 将 资源 文件 中 对 应 项 的 内 容 显示 出 来 。 以 User 类 的 userName 属 
性 为 例 ， 在 message_zh_CN properties 中 加 入 如 下 内 容 : 


然后 再 次 尝试 提交 一 个 用 户 名 为 空 值 的 表单 ， 就 会 发 现 错误 信息 已 经 发 生 了 相应 的 改 
变 ， 如 图 6-2 所 示 。 

熟悉 Java 的 读者 可 能 会 问 ，Java 的 properties 文件 是 不 支持 中 文 的 ， 含 有 中 文 都 需要 
先 用 JDK 提供 的 native2ascii 命令 将 其 转换 为 Unicode 编码 才 可 以 使 用 ， 为 什么 可 以 直接 
写 中 文 呢 :? 事实 上 ,是 Grails 在 后 台 自动 帮助 完成 了 这 个 任务 ,从 控制 台 的 日 志 上 可 以 看 
到 这 样 的 输出 : 


! 这 里 需要 注意 一 点 ，message zh_CN.properties 文件 编码 要 指定 为 UTF-8， 不 能 使 用 GBK。 


Create User 


圈 [dass User] 类 的 属性 [address] 不 能 为 空 
@ [class User] 类 的 属性 [emai] 不 能 为 空 

较 [dass User] 类 的 属性 [password] 不 能 为 空 
和 [class Usen] 类 的 属性 [phone] 不 能 为 空 
轩 用 户 名 不 能 为 空 


6-2 自 定义 userName 的 错误 信息 


使 用 message 方法 ， 可 以 取出 资源 文件 中 的 内 容 !。 
例如 : 


在 资源 文件 message_zh_CN.properties 中 加 入 : 


将 资源 文件 message.properties 另存 为 message_en.properties， 并 加 入 


当 客 户 端 系统 默认 语言 为 英文 或 在 URL 中 加 入 参数 lang=en， 页 面 上 将 显示 “User 
Name ”相应 地 ， 中 文系 统 或 在 URL 中 指定 lang=zh_CN 则 会 显示 简体 中 文 的 “用 户 名 ”。 
理解 了 上 面 的 例子 ， 再 用 Grails 创建 提供 多 国语 言 支持 的 网 站 就 不 难 了 。 

资源 文件 的 内 容 还 是 可 以 传 参数 的 。{0} 就 表示 传 入 的 第 一 个 参数 ，{1} 表 示 第 二 个 ， 
以 此 类 推 。 


1 GSP 中 还 可 以 使 用 g:message 标签 。 


例如 ， 在 页 面 中 编写 : 

Snessage (‘code: "test parans", args:[1,2,3]1)} 
或 

<gqimessage code="test params" args="stll,2,allr> 


并 且 在 资源 文件 中 编写 ; 
| es parans 雪 1:(01, 雪 2:01 数 3:027 


运行 时 则 输出 : 


一 般 来 说 ， 对 Domain 类 验证 时 产生 错误 的 信息 都 会 传 入 参数 : {0} 为 属性 名 ，41} 为 
类 名 ，{2} 为 属性 值 。 


6.2 ”用 户 注 册 


上 一 节 对 Grails 的 表单 验证 和 i18n 资源 文件 做 了 介绍 。 细 心 的 读者 也 许 会 问 ， 如 果 表 
单 验证 完全 是 依赖 于 对 Domain 的 验证 , 那么 与 Domain 无 关 的 表单 怎么 验证 ? 就 用 户 注册 
而 言 , 需要 提交 的 就 不 是 Domain， 因 为 这 里 需要 让 用 户 输入 两 次 密码 ， 并 校 验 这 两 次 的 输 
入 是 否 一 样 。 

在 Grails 中 ,除了 可 以 用 Domain 进行 表单 验证 ,还 可 以 用 命令 对 象 (Command Object)。 
它 一 样 可 以 用 contraints 闭 包 去 描述 数据 约束 ， 一 样 可 以 用 hasErrors 方法 去 验证 数据 是 否 
合法 。 唯 一 的 不 同 是 ， 它 与 数据 库 无 关 ， 因 而 不 能 执行 数据 库 的 相关 操作 。 

命令 对 象 的 类 名 为 XXXCommand， 它 可 以 存放 在 src\groovy 中 ， 也 可 以 直接 写 在 
Controller 类 中 。 在 src\groovy 中 创建 一 个 名 为 RegisterCommand.groovy 的 文本 文件 ， 然 后 
加 入 如 下 内 容 : 


RegisterCommand 的 目的 在 于 让 用 户 在 注册 时 ， 输 入 两 次 密码 ， 验 证 以 保证 两 次 输入 
的 密码 是 一 样 的 。 因 此 ， 为 RegisterCommand 添加 constraints 闭 包 : 


在 UserController 中 创建 一 个 空 action: def regester = 他， 然后 将 user\create.gsp 另存 为 
Wee 接 下 来 修改 register.gsp 的 内 容 ， 增 加 一 个 要 求 用 户 再 次 输入 密码 的 文 


由 于 现在 可 能 包含 错误 信息 的 对 象 不 局 限于 User Domain, RegisterCommand 也 可 能 包 
含 ， 因 此 需要 修改 用 于 输出 错误 列表 的 代码 为 : 


最 后 将 用 于 输入 password 的 文本 框 的 类 型 改 为 password， 将 输入 address 的 文本 框 改 
为 多 行文 本 框 (textarea)。 至 此 ， 页 面 的 改造 基本 完成 。 
接 下 来 修改 UserController 的 save action。 用 命令 对 象 去 接收 表单 更 加 容易 ， 只 需要 将 


它 写作 闭 包 的 参数 : 


此 时 ,表单 提交 的 数据 就 写 入 到 了 cmd 中 ,并且 数 据 也 经 过 了 验证 。 需 要 做 的 就 是 用 


hasErrors0 方 法 判断 数据 是 否 合法 。 
由 于 加 入 了 Command Object 用 于 检查 两 次 输入 的 密码 是 否 一 致 ， 原 本 的 保存 逻辑 会 


发 生 一 些 改变 ， 因 此 ， 修 改 代 码 如 下 : 


有 3 行 代码 的 修改 值得 关注 。 

L1: 使 用 Command Object 接收 表单 数据 。 

L2: 首先 将 usersaveO 改 为 user.validate()， 因为 此 时 需要 先 保证 Icmd.hasErrors() 才 能 保 
存 user。 但 是 ， 也 不 能 写成 IuserhasErrorsO && /cmd.hasErrors() && user.save()。 因 为 当 
cmd.hasErrors() 为 真 时 ，user.save0 将 不 再 被 执行 ， 所 以 uservalidate0 也 没有 执行 ， 于 是 传 
递 到 页 面 的 user 也 就 不 包含 错误 信息 了 。 这 里 当然 希望 一 次 提交 就 尽 可 能 多 地 发 现 错误 ， 
不 会 希望 只 发 现 一 个 “两 次 输入 的 密码 不 一 致 ”的 错误 。 

L3: 由 于 user 对 象 和 cmd 对 象 都 可 能 包含 错误 信息 ， 将 这 两 个 对 象 同时 传 给 页 面 
供 页 面 显示 错误 信息 。 

下 一 步 ， 修 改 资源 文件 1: 


重新 提交 表单 可 以 发 现 ， 当 提交 不 正确 数据 时 效果 如 图 6-3 所 示 。 页 面 上 还 有 一 些 元 
素 没有 进行 汉化 ， 不 过 相信 读者 现在 已 经 能 够 轻松 地 解决 国际 化 相关 的 任何 问题 了 ， 这 里 


1 本 书 默认 是 修改 简体 中 文 的 资源 文件 ，message_zh_CN.properties。 


就 不 再 次 述 。 


Create User 


加 地 址 不 能 为 宇 
加 emaiMiangshixing@gmail.com' 已 注册 ,请 使 用 89email 
密码 不 能 为 空 


加 电话 不 能 为 宝 
加 用 户 名 长 度 不 能 少 于 2 个 字符 
四 两 类 输入 的 密码 不 一 致 


Hi 


吻 Create 
6-3 用 户 注册 的 报错 效果 


当 提交 正确 的 数据 后 ， 如 果 用 户 保存 成 功 ， 将 自动 跳 转 到 显示 商品 列表 的 页 面 ， 并 将 
给 出 注册 成 功 的 提示 ， 如 图 6-4 所 示 。 
Goods List 


| @ 月 户 和 注册 所 功 


Grails 
Category: Book 
Grails Book... 
Price: 20.0 


Groovy 
Category: Book 


Groovy Bock. 
Price: 50.0 


图 6-4 注册 成 功 后 跳 转 到 商品 列表 页 面 


到 目前 为 止 ， 用 户 注册 的 功能 已 经 基本 实现 ， 但 还 不 够 完善 : 因为 用 户 的 密码 不 应 该 
直接 以 明文 的 形式 保存 在 数据 库 中 ， 而 应 该 加 密 一 下 。 下 一 节 将 完成 此 功能 。 


6.3 ”用 户 登录 


用 户 登 录 页 面 的 表单 很 简单 ， 只 有 两 个 表单 项 : 用 户 注册 时 使 用 的 E-mail 和 密码 : 


在 UserController 中 ， 定 义 loginCheck action， 则 这 个 action 中 需要 实现 如 下 逻辑 ; 
(1) 接收 表单 提交 的 email 和 password; 

(2) 查询 数据 库 中 是 否 包含 email 和 password 都 相符 的 user 记录 ; 

(3) 如 果 有 ， 则 在 Session 中 记录 user 的 id， 否 则 ， 通 过 flash.message 报错 ; 

(4) 登录 成 功 后 跳 转 。 


6.3.1 登录 的 数据 库 查 询 


数据 库 有 两 个 查询 条 件 ， 读 者 可 能 会 想 用 HibernateCriteriaBuilder 去 实现 这 个 查询 ， 
但 那样 未 免 有 点 杀 鸡 用 牛刀 了 。Grails 给 用 户 提供 了 一 个 动态 方法 ，findAllBy* 。 如 果 说 
Domain 类 的 list 方法 、save 方法 、get 方法 能 让 人 感到 神奇 ， 那 么 这 个 findAllBy 方法 一 定 
会 令 人 感到 震惊 。 因 为 这 个 findAllBy 方法 的 方法 名 是 可 变 的 。 

如 果 想 查询 出 email 为 XX 的 User， 可 以 用 UserfindAllByEmail(XX)。 如 果 想 用 email 
和 password 两 个 条 件 进行 联合 查询 ， 就 可 以 调用 UserfindAlIByEmailAndPassword(email， 
password)。findAllBy 方法 还 可 以 支持 比较 (大 于 、 小 于 、 大 于 等 于 、 小 于 等 于 、 不 等 于 ) 
查询 ， 如 : Goods.findAllByPriceLessThanEquals(priceHigh) 表示 查找 所 有 price 小 于 等 于 
priceHigh 的 记录 。findAllBy 方法 同样 支持 分 页 和 排序 ， 如 果 传 入 的 最 后 一 个 参数 为 Map， 
则 Map 中 名 为 max 和 offset 的 key 可 以 决定 如 何 分 页 (与 HibermateCriteriaBuilder 的 list 
方法 中 使 用 的 Map 完全 一 样 )。 

使 用 Domain 类 的 findAllBy 方法 可 以 实现 复杂 的 查询 逻辑 。 典 型 的 findAllBy 方法 可 
以 写成 样式 : Domain 类 名 .findAllIBy([ 属 性 名 ][ 比 较 方式 ][ 逻 辑 运算 ])?[ 属 性 名 ][ 比 较 方式 ]。 
其 中 比较 方式 包含 : 

(1) LessThan 一 一 小 于 给 定 值 ; 

(2) LessThanEquals 一 一 小 于 等 于 给 定 值 ; 

(3) GreaterThan 一 一 大 于 给 定 值 ; 

(4) GreaterThanEquals 一 一 大 于 等 于 给 定 值 ; 

(5) Like 一 一 与 SQL 的 like 等 价 ; 


(6) Tlike- 


与 like 类 似 ， 不 过 是 英文 字母 大 小 写 敏感 的 ; 
(7) NotEqual 一 一 不 等 于 给 定 值 ; 
(8) Between 一 一 在 两 个 值 之 间 ， 需 要 两 个 参数 ， 大 于 小 的 且 小 于 大 的 ; 


(9) IsNotNull 一 一 不 为 null 值 ， 无 需 参 数 ; 

(10) INull 一 一 为 null 值 ， 无 需 参数 。 

逻辑 运算 包含 ，And 和 Or。 

findAllBy 中 只 能 包含 两 个 查询 条 件 , 即 只 能 包含 一 个 逻辑 运算 符 !。 这 是 因为 findAllBy 
方法 本 来 就 是 用 于 解决 简单 的 查询 问题 ， 当 查询 逻辑 非常 复杂 的 时 候 ， 程 序 员 就 会 考虑 使 
用 HibernateCriteriaBuilder 或 者 HQL (Hibernate Query Language)。 

与 findAllBy 类 似 的 ， 还 有 findBy 和 countBy 方法 : findBy 方法 只 返回 符合 条 件 的 第 
一 条 记录 ，countBy 方法 会 返回 全 部 符合 条 件 的 记录 的 总 数 。 在 解决 登录 问题 的 时 候 ， 用 
findBy 刚好 合适 ， 因 为 这 里 只 需要 一 条 查询 结果 。 


6.3.2 ”使 用 Session 维持 会 话 


接 下 来 介绍 Grails 中 Session 的 使 用 。 

Session 在 计算 机 中 ， 尤 其 是 在 网 络 应 用 中 ， 称 为 “会 话 ”。 

对 于 计算 机 科学 领域 ， 在 特殊 的 网 络 领域 ，Session 是 一 种 持久 网 络 协议 ,在 用 户 (或 
用 户 代理 ) 端 和 服务 器 端 之 间 建 立 关 联 ， 从 而 起 到 交换 数据 包 的 作用 机 制 ，Session 在 网 络 
协议 (例如 Telnet 或 FTP) 中 是 非常 重要 的 部 分 器。 

Grails 中 Session 的 使 用 与 Map 相似 : 可 以 用 “.” 和 “[]” 两 种 方式 访问 其 数据 。 如 ， 
session.userId=user.id 和 session["userId"]=userid 都 表示 把 userid 保存 到 session.userId 中 ; 
调用 session.userld 或 者 session["userId"] 则 可 以 将 Session 中 的 userId 内 容 取出 ; 如 果 需 要 
清空 Session 的 内 容 ， 可 以 通过 session.invalidate0 方 法 实现 。 

基本 知识 介绍 到 这 里 ， 编 写 loginCheck action 代码 如 下 : 


相应 地 ， 退 出 系统 的 代码 如 下 : 


1 这 点 限制 可 能 会 在 新 的 版 本 中 得 到 改进 ， 可 以 参阅 : http://jira.codehaus.org/browse/GRAILS-1186。 


6.3.3 自 定义 Codec 实现 对 密码 加 密 


到 目前 为 止 ， 用 户 注册 和 用 户 登录 功能 已 经 基本 完成 ， 但 在 上 一 节 结 尾 时 曾 提 到 ， 需 
要 将 用 户 的 密码 加 密 之 后 再 保存 到 数据 库 中 。 在 Groovy 中 要 实现 加 密 并 不 困难 ， 可 以 直 
接 使 用 Java 的 类 库 实现 : 


虽然 对 密码 加 密 只 需要 3 行 代码 ， 但 在 注册 和 登录 都 需要 调用 ， 因 而 最 好 将 其 封装 成 
一 个 工具 方法 。 回忆 一 下 表 2-1 中 Grails 生成 的 项 目 目录 结构 。Grails 中 约定 编写 工具 方法 
类 的 文件 夹 是 utils。 因 而 ， 在 utils 文件 夹 中 创建 一 个 名 为 PasswordCodec.groovy 的 文件 ， 
其 内 容 如 下 : 


这 里 是 按 Grails 中 的 约定 实现 自 定 义 编码 类 (XXXXCodec 类 )。 类 名 PasswordCodec 
是 Grails 的 一 种 约定 : 一 定 要 写成 XXXCodec， 并且 约定 它 一 定 要 包含 一 个 名 为 encode 的 
闭 包 。 约 定 了 这 么 多 内 容 ， 目 的 很 简单 ， 为 了 调用 更 加 容易 。 定 义 了 上 面 的 类 后 ， 可 以 通 
过 如 下 调用 实现 加 密 : 


确实 很 神奇 。 定 义 了 utils 类 ， 就 可 以 在 任意 的 对 象 上 调用 encodeAsXXX 方法 。 这 在 
传统 的 静态 语言 编程 中 是 不 可 想象 的 ， 完 全 是 得 益 于 Groovy 的 MOP 编程 技术 ,更 多 关于 
Groovy 的 MOP 内 容 ， 会 在 本 书 的 最 后 一 部 分 进行 讨论 。 

有 了 这 个 PasswordCodec 类 ， 用 户 注册 和 登录 都 需要 先 对 密码 进行 encode。 因 此 ， 将 
注册 和 登录 的 代码 修改 为 : 


6.4 登录 保护 


对 于 需要 用 户 “ 先 登录 ， 后 访问 ”的 资源 ， 可 以 在 相应 的 action 中 加 入 这 样 的 代码 : 


但 是 通常 情况 下 ， 有 这 样 需 求 的 页 面 并 不 在 少数 ， 甚 至 在 比例 上 都 不 在 少数 。 如 果 每 
个 action 都 重复 写 着 这 样 的 代码 ,会 带 来 大 量 的 重复 代码 ， 严 重 影响 程序 的 “美感 ”。 针 对 
这 个 问题 ，Grails 提供 了 两 种 解决 方案 。 

(1) 方案 一 : 使 用 Grails 的 beforeInterceptor 拦截 器 。 

Grails 提供 了 两 种 拦截 器 ， 分 别 是 beforeInterceptor 和 afterInterceptor。 它 们 的 作用 是 
在 action 执行 之 前 或 之 后 自动 调用 。 因 此 ， 可 以 在 beforeInterceptor 中 进行 登录 检查 ， 并 且 


在 需要 的 情况 下 ， 执 行 跳 转 。beforeInterceptor 有 两 种 写法 ， 一 种 是 直接 定义 为 一 个 闭 包 。 
此 时 ，controller 中 的 任何 action 都 会 被 拦截 : 


另 一 种 方式 , 将 beforeInteceptor 定义 为 一 个 Map。 这 种 方式 比较 灵活 , 配置 性 也 较 强 : 


以 当前 的 程序 为 例 ， 可 以 通过 如 下 代码 实现 登录 保护 : 


车 用 户 未 登录 时 调用 拦截 器 ， 则 跳 转 到 登录 页 面 ， 并 且 拦 截 闭 包 会 返回 false。 如 果 拦 
截 闭 包 返回 false， 则 被 拦截 的 action 将 不 再 被 执行 ， 这 就 达到 了 保护 登录 的 目的 。 

然而 ， 上 面 的 程序 还 有 一 个 小 问题 : 由 于 在 Controller 中 定义 了 auth 闭 包 ， 则 auth 也 
会 被 当 作 一 个 action 来 处 理 ， 可 以 通过 url: GDepotuserauth 访问 到 它 。 这 并 不 是 这 里 想 
要 的 .为 了 解决 这 个 问题 ,把 auth 定义 成 一 个 方法 , 在 定义 beforeInterceptor 的 时 候 用 this.& 
将 auth 方 法 转换 为 闭 包 : 


(2) 方案 二 : 使 用 Grails 的 filter 技术 。 

拦截 器 使 用 虽然 简单 ， 但 也 存在 一 定 的 不 足 ， 它 只 能 作用 于 单一 的 控制 器 。 若 要 在 更 
大 范围 内 进行 拦截 操作 ， 可 以 选择 filter。 

典型 的 filter 类 的 定义 模式 如 下 : 


Filter 类 要 存放 在 grails-app\conf 文件 夹 下 面 ， 它 的 类 名 一 定 是 XXXFilters， 类 中 一 定 
要 包含 一 个 名 为 filters 的 闭 包 。 在 中 这 一 级 别 ， 如 fnterl， 可 以 指定 filter 的 作用 范围 : 通 
过 controller 和 action 或 者 通过 uri， 可 以 确定 当前 filter 将 拦截 哪些 url。 在 filterl 内 部 , 可 
选择 定义 3 种 拦截 方式 ， 分 别 是 before、after 和 afterView。 与 拦截 器 类 似 ， 如 果 在 before 
闭 包 内 返回 false， 被 拦截 的 action 将 不 再 执行 。 对 于 当前 的 登录 保护 ， 可 以 使 用 如 下 代码 
实现 保护 : 


使 用 beforeInterceptor 或 者 filter 可 以 实现 简单 的 登录 保护 ， 若 需要 进行 更 为 复杂 和 精 
细 的 权限 控制 ， 可 以 使 用 JSecurity 或 Acegi 等 Grails 插件 来 实现 ， 这 部 分 内 容 将 在 后 面 的 
章节 里 进行 讨论 。 


6.5 ”本 章 小 结 


本 章 结合 用 户 注册 、 用 户 登 录 、 退 出 , 以 及 登录 保护 这 些 功能 的 实现 过 程 , 介绍 了 Grails 
中 表单 验证 、il8n 资源 文件 支持 、Command Object、 数 据 库 查询 的 findAllBy* 系 列 方法 、 
Session 的 使 用 、beforeInterceptor 拦截 器 以 及 filters 的 使 用 。 下 一 章 将 结合 前 几 章 所 学 的 知 
识 点 ， 完 成 购物 车 及 订单 的 提交 与 查看 。 


购物 车 与 订单 
a/ 章 


本 章 将 开发 购物 车 与 订单 相关 的 功能 ， 对 前 面 各 章 的 知识 点 进行 综合 应 用 。 此 外 ， 通 
过 本 章 读者 还 会 学 习 到 : Service 类 的 使 用 、 模 板 页 面 的 使 用 。 


7.1 购物 车 的 查看 与 管理 


7.1.1 定义 购物 车 的 Domain 类 


现在 开发 购物 车 的 功能 ， 允 许 用 户 把 商品 添加 到 购物 车 中 。 首 先 需 要 设计 Domain 类 。 
Cart 类 是 购物 车 类 ，LineItem 类 是 购物 车 中 的 商品 记录 


class LineItem { 
Goods goods // 进 入 购物 车 的 商品 
int itemNumber = 1 // 购 买 的 数量 
static belongsTo = [cart:Cart] // 当 前 LineItem 属于 哪个 购物 车 
static constraints = { 
itemNumber (min:1) 
} 
} 


一 条 LineItem 记录 包含 一 件 商品 ， 并 记录 它 的 购买 数量 。static belongsTo = [cart:Cart] 
指定 了 LineItem 的 属 主 (owner) 是 Cart， 并 可 以 通过 cart 属性 去 访问 它 的 owner。 指 定 了 
owner 就 意味 着 对 LineItem 实现 了 级 联 删除 : 当 某 条 cart 记录 被 删除 时 ， 所 有 属于 它 的 
lineItem 都 将 自动 删除 。 如 果 存 在 多 个 owner， 可 以 在 Map 中 用 逗号 分 隔 ， 如 : 


static belongsTo = [ownerl:OwnerlClassname, owner2: Owner2Classname, ...] 
接 下 来 设计 Cart 类 如 下 : 


enum Cartstatus{NEW,ORDERED} 

class Cart { 
static hasMany = [lineItems:LineItem] 
static belongsTo = [user:User] 


Cartstatus status = Cartstatus.NEW 


定义 Cart 类 前 , 先 定义 了 CartStatus 枚 举 , 用 于 标识 购物 车 的 两 个 不 同 的 状态 :“ 新 购 
物 车 ”和 “已 下 单 ”。 由 CartStatus 定义 的 status 属性 用 于 定义 购物 车 的 状态 ， 并 指定 默认 
值 为 CartStatusNEW。 查 看 Grails 生成 的 数据 库 表 结构 ， 会 发 现 Domain 的 枚 举 类 型 在 数 
据 库 中 被 映射 为 数字 类 型 。 


static hasMany 用 于 定义 “一 对 多 ”关系 。static hasMany-[lineItems:LineItem] 指 定 了 
Cart 与 LineItem 是 “一 对 多 ”的 关系 ,并 且 可 以 通过 lineItems 属性 访问 Cart 的 多 个 LineItem。 
Cart 类 还 定义 了 一 个 totalPrice 方法 ， 用 于 计算 购物 车 中 商品 的 价格 总 和 。 

设计 Cart 的 status 属性 ， 需 要 默认 两 个 事实 : 

(1) 只 能 向 status 为 NEW 的 Cart 添加 商品 ; 

(2) 每 位 用 户 最 多 只 能 有 一 个 状态 为 NEW 的 Cart。 

这 两 点 需要 用 程序 去 保证 ， 因 此 ， 读 取出 当前 用 户 购物 车 的 代码 如 下 《该 代码 的 创建 
将 在 下 一 小 节 介绍 ): 


上 面 的 代码 可 以 实现 为 当前 用 户 找 出 Cart， 因 为 逻辑 比较 复杂 ， 所 以 效率 不 够 理想 ， 
需要 进行 适当 的 优化 。 设 想 ， 如 果 在 session 中 保存 了 当前 用 户 购物 车 的 id4， 再 次 读 取 Cart 
将 变 得 十 分 简单 和 高 效 。 将 上 面 的 代码 进行 优化 如 下 : 


利用 session 去 缓存 cart.id 可 以 提高 查找 cart 的 效率 ， 但 不 要 忘 了 一 点 ， 那 就 是 ， 当 购 
物 车 状态 发 生变 化 时 ， 应 该 将 session 中 的 cartId 清除 掉 。 这 是 之 前 默认 的 两 个 事实 所 决 
定 的 。 


7.1.2” 定义 OrderService 类 


由 于 所 有 需要 与 购物 车 打交道 的 业务 ， 都 需要 先 调用 这 段 代码 ， 这 样 就 十 分 有 必要 将 
它 封装 起 来 。Grails 可 以 通过 创建 服务 Service)， 帮 助 程序 员 把 可 重用 的 业务 逻辑 封装 起 
来 。 执 行 Grails 的 create-service 命令 ， 可 以 创建 Service: 


可 以 看 到 Grails 在 grails-app\services 文件 夹 中 ， 创 建 了 一 个 名 为 OrderService 的 类 。 
了 解 Spring 的 读者 ， 应 该 对 这 种 命名 方式 不 会 陌生 。Service 类 会 被 Spring 的 容器 所 托管 ， 
从 而 拥有 了 “依赖 注入 ”与 “事务 处 理 ” 等 特性 !。 

如 果 在 Service 类 中 定义 static transactional = true， 则 表示 这 个 Service 类 的 每 个 方法 ， 


1 依赖 注入 DI 与 控制 反 转 IoC 是 同一 个 概念 ， 读 者 可 以 访问 wwwspringframework.org 去 了 解 相关 
的 内 容 ， 不 了 解 这 些 概 念 不 会 影响 学 习 这 一 章 的 知识 。 


都 要 被 当成 一 个 事务 去 处 理 :。 这 正 是 这 里 想 要 的 ， 因 此 ， 修 改 OrderService 的 内 容 如 下 : 


在 OrderService 类 中 定义 了 prepareCart (session) 方法 ， 调 用 这 个 方法 ， 可 以 得 到 当 
前 用 户 的 购物 车 。 以 传统 的 开发 Spring 应 用 程序 的 经 验 ， 要 避免 将 session 这 样 的 东西 传 
入 到 处 理 业 务 逻辑 的 Service 类 中 。 因 为 那样 会 使 Service 类 与 Web 容器 耦合 在 一 起 ， 从 而 
给 自动 化 测试 或 项 目 移植 带 来 了 困难 。 但 是 ， 在 Grais 中 不 用 担心 这 个 问题 。 在 定义 
prepareCart 方法 时 仅 指 定 了 参数 的 名 称 ， 并 没有 指定 参数 的 类 型 。 因 此 在 调用 prepareCart 
时 ， 只 需要 传 入 一 个 与 session 用 法 相似 (例如 Map， 都 可 以 用 “.” 和 “[]” 访 问 数据 成 员 》 
的 对 象 即 可 。 这 也 是 动态 语言 编程 的 一 大 特色 。 

由 于 Service 类 的 对 象 是 由 Spring 容器 所 托管 的 ， 因 此 调用 Service 类 非常 简单 。 可 以 
使 用 Spring 的 依赖 注入 机 制 将 其 注入 到 需要 调用 它 的 类 中 。 例 如 ， 现 在 需要 在 
GoodsController 中 调用 OrderService 类 ， 则 只 需要 在 GoodsController 中 添加 一 个 名 为 
orderService 的 属性 : 


1 事务 是 应 用 程序 中 一 系列 严密 的 操作 ， 所 有 操作 必须 成 功 完成 ， 否 则 在 每 个 操作 中 所 做 的 所 有 更 
改 都 会 被 撤销 。 事 务 具 有 原子 性 ， 一 个 事务 中 的 一 系列 的 操作 要 么 全 部 成 功 ， 要 么 一 个 都 不 做 。 


Spring 容器 会 自动 将 容器 中 的 orderService 实例 传 入 到 GoodsController 中 ， 而 无 需 对 
它 进行 初始 化 , 这 就 是 所 谓 的 依赖 注入 。 并且 , Spring 不 单 能 够 向 Controller 中 注入 Service 
实例 ， 在 Command Object、Taglib 类 、 单 元 测试 类 ， 或 者 其 他 Service 类 中 ， 只 要 定义 了 
与 Service 类 名 相同 的 属性 ，Spring 都 会 自动 注入 可 用 的 实例 。 这 里 要 强调 一 点 ， 不 要 尝试 
自己 用 new 初始 化 Service 类 。 因 为 这 样 创建 的 Service 实例 没有 运行 在 Spring 容器 中 , 它 
的 事务 管理 特性 和 依赖 注入 特性 是 不 可 用 的 。 


7.1.3 显示 购物 车 


接 下 来 要 在 goods\list.gsp 页 面 显示 购物 车 。 要 实现 这 个 功能 ， 需 要 先 在 Controller 中 
取出 购物 车 的 数据 。 问 题 又 来 了 ，GoodsController 中 有 两 个 action 最 终 会 调用 list.gsp 进行 
显示 ， 要 在 两 个 action 中 都 加 入 取 购 物 车 的 代码 吗 ? 回忆 一 下 登录 保护 那 一 节 的 知识 点 ， 
可 以 在 afterInterceptor 中 做 这 件 事情 ， 因 为 在 afterInterceptor 中 可 以 修改 action 传 给 GSP 
的 数据 。 有 具体 的 代码 如 下 : 


在 listgsp 中 加 入 如 下 代码 用 于 显示 购物 车 : 


上 面 的 代码 对 cartlineItems 进行 遍历 ， 然 后 输出 每 一 条 lineItem 所 引用 的 goods 的 信 
息 ， 以 及 lineItem 中 记录 的 商品 条 数 。 对 于 传统 的 数据 库 编程 ， 实 现 这 种 通过 Cart 找到 
LineItem， 再 通过 LineItem 去 访问 Goods， 都 需要 使 用 表 连 接 。 但 此 时 只 是 利用 了 Domain 
之 间 的 关联 ， 就 实现 了 多 表 的 数据 访问 。 这 是 因为 Hibernate 有 一 个 延 时 加 载 (Lazy load) 
的 特性 ， 利 用 这 个 特性 ， 程 序 的 开发 会 变 得 简单 许多 。 

然而 ， 延 时 加 载 有 可 能 带 来 性 能 的 问题 ， 因 为 使 用 延 时 加 载 有 可 能 会 导致 执行 N 十 1 
次 查询 。 以 上 面 的 代码 为 例 ， 取 cart.lineItems 的 时 候 ， 需 要 进行 一 次 数据 库 查 询 。 假 设 取 
出 了 NN 条 记录 , 在 遍历 这 条 记录 的 时 候 ， 再 分 别 去 取 每 条 LineItem 的 Goods， 则 此 时 会 
对 Goods 表 进 行 N 次 查询 。 为 解决 这 样 的 性 能 问题 ，Hibernate 提供 了 两 种 方案 : 一 种 是 
设置 fetchMode， 使 之 在 一 次 查询 中 完成 抓 取 ， 另 一 种 是 使 用 缓存 ， 使 得 N 次 查询 都 在 组 
存 中 进行 ， 从 而 使 得 数据 库 的 查询 变 为 1 次 查询 。 关 于 fetchMode 和 缓存 相关 的 内 容 ， 将 
在 第 11 章 进行 讨论 。 


7.1.4 维护 购物 车 
接 下 来 开发 “向 购物 车 添加 商品 ”的 代码 。 在 商品 列表 的 表格 中 添加 一 列 : 


在 这 一 列 中 添加 了 一 个 按钮 , 单 击 按钮 会 向 addToCart action 提交 当前 商品 的 id。 接 下 
来 在 Controller 中 实现 addToCart。 


addToCart 的 业务 逻辑 如 下 : 

(1) 首先 ， 应 取出 当前 用 户 的 购物 车 ; 

(2) 判断 当前 购物 车 中 是 否 包含 当前 商品 ; 

(3) 如 果 包 含 ， 则 对 lineItem 的 itemNumber 属性 值 加 1; 

(4) 如 果 不 包含 ， 则 添加 一 条 lineItem， 且 指定 它 的 itemNumber 为 1。 

因为 addToCart 也 相对 比较 复杂 ， 所 以 将 这 部 分 代码 封装 到 OrderService 中 ， 添 加 如 
下 方法 : 


此 时 GoodsController 中 的 代码 就 简单 多 了 ， 可 写 为 : 


运行 一 下 程序 ， 单 击 “ 添 加 到 购物 车 ”按钮 ， 就 可 以 把 商品 添加 到 购物 车 当中 ， 如 图 
7-1 所 示 。 

接 下 来 开发 “从 购物 车 移 除 ” 的 功能 。 

首先 修改 页 面 ， 在 显示 购物 车 的 表格 中 添加 一 列 : 
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图 7-1 实现 将 商品 添加 到 购物 车 


<td> 


<g:form action="removeFromCart" method="post"> 
<input type="hidden" name="id" value="${lineItem.id}"> 
<input type="submit" value="${message (code:'cart.remove')}" 
onClick="return onfirm('$ {message (code:'confirm. 
removeFromCart')}')"> 

</g:form> 

</td> 


添加 按钮 ， 单 击 后 会 向 GoodsController 的 removeFromCart action 提交 表单 ， 表单 中 包 
含 了 要 被 删除 的 lineItem 的 id。removeFromCart action 中 需要 的 事情 很 明确 ， 即 根据 表单 
提交 的 id 值 ， 删 除 相应 的 lineItem: 


def removeFromCart = { 
def lineItem = LineItem.get (params.id) 
if(lineItem) { 
lineItem.delete() 
} 
redirect (action:1ist) 


} 


上 面 的 代码 能 够 实现 删除 购物 车 中 的 商品 ， 但 它 有 一 个 不 小 的 安全 隐患 。 它 没有 判断 
要 删除 的 lineItem 是 否 真 的 属于 当前 用 户 的 购物 车 ， 恶 意 的 用 户 可 以 利用 这 个 漏洞 去 删除 
任意 的 一 条 lineItem， 这 将 给 整个 系统 带 来 严重 的 危害 。 因 此 ， 需 要 改进 一 下 程序 : 


def removeFromCart = { 
def lineItem = LineItem.get (params.id) 
// 防止 用 户 随意 提交 id 
if(lineItem && lineltem.cart.id == session.cartId) { 
lineItem.delete() 
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} 


redirect (action:1ist) 


} 


刷新 一 下 页 面 ， 单 击 “ 从 购物 车 移 除 ”按钮 ， 弹 出 一 个 提示 框 ， 询 问 是 否 移 除 商品 ， 
如 图 7-2 所 示 。 
您 的 购物 车 
商品 名 称 价格 
Groow 50.0" 3 Jo 


总 计 170.0 Windows Internet Explorer 
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图 7-2 单 击 “ 从 购物 车 移 除 ”按钮 


再 单 击 “ 确 定 ” 按 钮 ， 该 商品 就 从 购物 车 中 消失 了 ， 显 示 效 果 如 图 7-3 所 示 。 
您 的 购物 车 
商品 名 称 “价格 
cnis 20.0°1 /GR 


Bit 200 
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图 7-3 ”成功 删除 一 条 购物 车 中 的 记录 
接 下 来 ， 开 发 修改 购物 车 中 物品 数量 的 功能 ， 仍 然 在 显示 购物 车 的 表格 里 添加 一 列 : 


<td> 
<g:form action="changeItemNumber" method="post"> 
<input type="hidden" name="id" value="${lineItem.id}"> 
<input type="text" size="2" 
name="itemNumber" value="${lineItem.itemNumber}" > 
<input type="submit™ 


这 一 列 包含 一 个 文本 框 和 一 个 提交 按钮 。 表 单项 包含 lineItem 的 id 和 要 修改 的 商品 数 
量 。 处 理 表单 的 action 是 changeItemNumber， 要 实现 用 表单 提交 的 数值 去 更 新 指定 的 
lineItem， 程 序 代码 如 下 : 


这 部 分 程序 与 Grails 自动 生成 的 update action 十 分 相似 ， 这 里 不 再 资 述 。 再 次 刷新 页 
面 ， 单 击 “ 修 改 ” 按 钮 ， 可 以 看 到 运行 效果 如 图 7-4 所 示 。 
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图 7-4 修改 购买 数量 


本 节 实 现 了 购物 车 的 显示 ， 实 现 了 向 购物 车 添加 商品 ， 还 实现 了 从 购物 车 中 移 除 商品 
和 编辑 购物 车 中 商品 的 数量 。 下 一 节 将 开发 提交 订单 的 功能 。 


7.2 ”订单 的 提交 


7.2.1 定义 订单 的 Domain 类 


订单 的 内 容 肯 定 要 包含 用 户 、 用 户 购买 的 商品 信息 。 将 购物 车 包含 进来 ， 就 包含 了 全 
部 的 已 购 商品 信息 。 订 单 中 应 该 还 包含 一 份 单独 的 收 货 人 信息 ， 因 为 提交 订单 的 用 户 可 能 
会 不 使 用 注册 时 提交 的 地 址 作为 收 货 地 址 。 设 计 订单 的 Domain 类 如 下 : 


由 于 order 是 SQL 语句 中 的 保留 字 ， 因 此 用 “Orders” 作 为 Domain 的 类 名 。 枚 举 
OrderStatus 中 为 订单 定义 了 3 种 状态 : NEW (新 订单 )、SHIPPED (已 发 货 )、CLOSE (处 
理 完 毕 )。orderDate 和 shipDate 两 个 属性 分 别 记 录 了 下 单 的 时 间 和 发 货 的 时 间 。 由 于 未 发 
货 的 订单 没有 发 货 时 间 ， 因 此 在 constraints 中 允许 shipDate 的 值 可 以 为 null。Orders 类 中 
还 对 cart 定义 了 一 个 validator， 用 于 防止 用 户 提交 不 包含 任何 商品 的 订单 。 


7.2.2 ”提交 订单 的 表单 页 面 


接 下 来 ， 运 行 命令 grails generate-all Orders， 让 Grails 自动 生成 提交 订单 的 Scaffold 


页 面 。 

这 里 仍 选用 create 页 面 作 为 订单 提交 的 页 面 ， 不 过 这 回 Grails 生成 的 页 面 就 离 预 期 相 
差 得 太 远 了 。 但 是 ， 如 果 能 够 在 这 个 基础 上 进行 修改 ， 也 明显 减轻 了 负担 。 

接 下 来 修改 create 页 面 。 首 先 ， 要 将 购物 车 的 内 容 显示 在 页 面 上 ， 然 后 将 提交 订单 时 
不 能 修改 的 属性 都 去 掉 。 

在 页 面 上 显示 购物 车 的 内 容 ， 可 以 将 商品 列表 (views\goods\list.gsp〉 那 页 的 部 分 代码 
粘贴 过 来 。 但 这 样 做 , 又 会 有 大 量 的 重复 代码 出 现 。 使 用 Grails 提供 的 模板 机 制 (template )， 
可 以 解决 这 个 问题 。 在 views 文件 夹 下 创建 一 个 名 为 _showCart.gsp 的 文件 ， 然 后 将 
goods/list.gsp 中 用 于 显示 购物 车 的 代码 移动 到 showCart.gsp 中 ， 最 后 在 goods/list.gsp 中 使 
用 下 面 一 行 代码 来 调用 模板 : 


g:render 标签 可 以 用 于 输出 模板 页 面 的 内 容 。 其 中 template 属性 为 必 填 属性 ， 用 于 指 
定 模板 页 面 的 文件 名 。 如 果 template 的 值 以 “/” 开 头 ， 则 表示 模板 文件 在 views 文件 夹 下 ， 
如 果 不 以 “/” 开 头 ， 则 表示 在 当前 路 径 下 。 注 意 /showCart 与 _showCart.gsp 的 对 应 关系 。 
g:render 标签 还 可 以 向 模板 页 面 传递 数据 ， 通 过 model 属性 ， 可 以 将 封装 成 Map 的 数据 传 
递 给 模板 页 面 ， 供 其 使 用 。 更 多 关于 g:render 的 内 容 ， 在 后 面 章节 里 会 有 介绍 。 

通过 模板 机 制 ， 只 需要 一 行 代码 ， 就 可 以 将 购物 车 显示 在 orders\create.gsp 页 面 中 。 但 
此 时 ， 订 单 页 面 中 购物 车 的 部 分 功能 无 法 使 用 。 这 是 因为 在 表单 中 没有 指定 controller， 默 
认 会 提交 到 当前 Controller， 即 OrdersController。 这 个 问题 不 难 解决 。 为 _showCart.gsp 中 
的 两 个 form 都 指定 controller 为 “goods” 即 可 。 

但 很 不 幸 ， 问 题 并 没有 结束 。 以 “ 移 除 商品 ”为 例 ，removeFromCart action 的 代码 
如 下 : 


最 后 一 行 的 跳 转 处 又 出 了 问题 ， 因 为 如 果 是 在 提交 订单 的 页 面 移 除了 购物 车 中 的 内 
容 ， 显 然 应 该 跳 转 回 提交 订单 的 页 面 才 对 。 同 样 的 问题 也 会 出 现在 查询 时 : 如 果 在 显示 查 
询 结果 的 页 面 上 修改 了 购物 车 的 内 容 ， 一 样 会 跳 转 到 list 页 面 。 为 解决 这 个 问题 ， 需 要 向 
action 提交 一 个 参数 ， 用 于 指定 下 一 步 要 跳 转 到 的 URL。 为 此 ， 在 _showCart.gsp 的 每 个 表 
单 中 都 加 入 如 下 的 代码 (goods/list.gsp 页 面 的 addToCart 表单 中 , 也 应 该 加 入 下 面 的 代码 ): 


request.forwardURI 可 以 获取 到 当前 页 面 的 URL (不 包含 参数 ); request.queryString 可 


以 获取 当前 HTTP 请 求 的 参数 信息 。 因 此 通过 “$f{request.forwardURI}?$ {request.query- 
String} ”就 可 以 得 到 当前 请 求 的 完整 的 URL 了 .经 过 上 面 的 修改 ,得 到 完整 的 _showCart.gsp 
的 内 容 如 下 : 


ek 


相应 地 ， 还 需要 修改 Controller 中 的 程序 ， 将 addToCart 、removeFromCart 、 
changeItemNumber 这 3 个 action 中 的 redirect(action:lisb) 蔡 换 成 下 面 的 代码 : 


完成 了 显示 购物 车 的 功能 ， 接 下 来 开发 订单 提交 的 表单 页 面 。 首 先 需要 删除 Grails 自 
动 生成 的 表单 中 不 合 逻 辑 的 内 容 : Price、Ship Date、Cart、Order Date、Status、User。 然 
后 将 Address 对 应 的 文本 框 蔡 换 为 多 行文 本 框 ， 并 将 Create 按钮 的 标签 改 为 “确认 下 单 ”。 

然后 ， 需 要 修改 OrdersController 的 create action。 这 里 需要 做 两 件 事情 : 一 件 是 读 取 
购物 车 的 数据 ， 因 为 create 页 面 上 也 需要 显示 购物 车 ， 另 一 件 是 用 当前 用 户 的 userName、 
phone 和 address 去 初始 化 订单 的 对 应 属性 。 具 体 代码 如 下 : 


提交 订单 的 表单 页 面 显 示 效果 如 图 7-5 所 示 。 
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图 7-5 提交 订单 的 表单 页 面 


显然 , OrdersController 中 的 每 个 action 都 需要 登录 保护 ,此 外 OrdersController 中 也 需 
要 有 orderService 这 个 属性 ， 使 得 Spring 能 够 将 容器 中 的 OrderService 实例 注入 进来 。 到 
目前 为 止 ， 提 交 订 单 的 表单 页 面 已 经 基本 完成 。 接 下 来 要 开发 保存 订单 的 功能 。 


7.2.3 ”订单 的 保存 


订单 保存 ， 需 要 将 orders 记录 保存 到 数据 库 ， 同 时 需要 将 cart 的 status 属性 设置 为 
CartStatus.ORDERED。 这 是 一 个 比较 典型 的 事务 处 理 ， 因 此 很 自然 地 就 会 把 这 部 分 功能 放 
在 OrderService 类 中 实现 。 于 是 在 OrderService 中 添加 saveOrder 方法 : 


一 


saveOrder 方法 有 两 个 参数 : 一 个 是 session， 另 一 个 是 根据 表单 构造 的 orders 对 象 。 
订单 的 保存 过 程 并 无 特别 之 处 ， 先 是 为 orders 的 cart、user、orderDate、price 、status 属性 
赋值 ， 然 后 在 orders 保存 成 功 的 前 提 下 ， 对 cart 进行 更 新 并 保存 。 只 有 当 orders 与 cart 的 
更 新 都 成 功 的 时 候 ， 程 序 才 会 执行 到 四 处 ， 返 回 orders; 和 否则， 程序 一 定 会 执行 到 @ 处 ， 
抛 出 异常 并 退出 。 这 里 的 抛 出 异常 ， 正 是 为 Spring 的 事务 管理 所 准备 的 。 当 Spring 容器 检 
测 到 这 个 异常 时 ， 会 对 事务 进行 回 滚 操作 ， 从 而 保证 了 事物 操作 的 原子 性 。 

OrdersController 中 的 save action 只 需要 调用 OrderService 中 的 saveOrder 方法 ， 因 此 
十 分 简单 : 


7.3 ”订单 的 查看 


完成 了 提交 订单 ， 接 下 来 开发 为 顾客 显示 订单 的 页 面 ， 从 action 开始 ，list action 中 需 
要 查询 当前 用 户 的 订单 列表 。 假 定 需 要 显示 3 种 类 别 的 订单 :全 部 订单 、 新 订单 、 已 经 发 
货 的 订单 。 这 3 种 状态 由 一 个 url 的 参数 “status ”表示 : status=new 表示 新 订单 ; status=old 
表示 已 经 发 货 的 订单 ，status 为 其 他 值 则 表示 全 部 显示 。 程 序 代码 如 下 : 


程序 逻辑 很 清晰 ， 也 没有 新 的 知识 点 ， 无 非 是 使 用 findAllBy 方法 进行 查询 ， 并 且 用 
一 个 map (params) 去 控制 分 页 与 排序 。 读 者 如 果 忘 记 了 相关 的 知识 点 ， 可 以 翻 看 前 一 章 


回顾 一 下 。 接 下 来 开发 显示 订单 列表 的 list.gsp 页 面 。 
首先 制作 几 个 导航 链接 ， 分别 指向 “购买 商品 ”(goods/list) 、“ 新 订单 ” 
(orders/list?status=new)、“ 已 发 货 订单 ”(orders/list?status=old) 和 “全 部 订单 ”(orders/list)。 


然后 制作 显示 订单 列表 的 表格 : 


LE 


标签 g:sortableColumn 会 输出 一 个 表 头 (<th>)， 并 且 这 个 表 头 中 包含 一 个 链接 ， 链 接 
中 的 参数 可 以 指定 排序 方式 。g:sortableColumn 的 property 属性 决定 使 用 什么 字段 进行 排序 。 
title 属性 用 于 指定 要 显示 的 文本 。 如 果 要 输出 的 内 容 需 要 从 资源 文件 中 读 取 ， 则 可 以 用 
titleKey 属性 指定 资源 的 key 。 编 写 <g:sortableColumn property = "price" titleKey = 
"orders.price" /> 会 输出 形 如 list?sort=price 的 链接 。 如 果 链 接 中 需要 添加 其 他 的 参数 ， 则 需 
要 使 用 params 属性 。 以 当前 的 情况 为 例 ， 需 要 给 链接 的 URL 中 添加 一 个 status 属性 ， 
此 使 用 了 params 属性 如 下 : params="${[status : params.status]}"。 

标签 g:formatDate 用 于 输出 格式 化 的 日 期 ，format="yyyy-MM-dd" 表 示 输 出 格式 为 
“2008-08-08”。 

接 下 来 ， 输 出 分 页 导航 : 


页 面 的 显示 效果 如 图 7-6 所 示 。 
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图 7-6 用 户 订单 列表 
总 的 来 说 ， 这 个 页 面 是 比较 复杂 的 ， 涉 及 到 分 页 、 表 头 的 排序 等 。Grails 通过 在 链接 


中 加 入 sort、order、max、offset 这 样 的 参数 ， 可 以 让 action 中 的 params 成 为 包含 上 述 key 
的 Map， 并 通过 这 个 Map 影响 Domain 类 对 数据 库 的 查询 。 这 确实 是 一 个 很 精巧 的 设计 ， 
如 果 读 者 觉得 这 部 分 内 容 理解 起 来 有 困难 ， 不 妨 在 action 中 加 入 一 行 println params， 通 过 
反复 单 击 页 面 上 的 排序 或 分 页 链接 ， 查 看 打印 出 的 params 内 容 。 通 过 反复 多 次 的 观察 , 相 
信 一 定 可 以 理解 其 中 的 奥妙 。 

表格 的 最 后 一 列 用 于 显示 订单 状态 ， 当 状态 为 “已 发 货 ” 时 ， 该 列 还 将 包含 一 个 表单 ， 
表单 中 有 一 个 按钮 ， 用 户 单 击 该 按钮 就 表示 商品 已 经 收 到 。 提 交 表 单 时 ， 表 单项 中 包含 了 
订单 的 id， 相应 的 表单 提交 的 action 中 的 代码 如 下 : 


action 中 执行 的 操作 就 是 把 指定 orders 的 status 改 为 CLOSE 。orders.userid = 
session.userld 是 为 了 防止 恶意 的 提交 ， 道 理 和 上 一 节 修改 lineItem 一 样 ， 这 里 不 再 效 述 。 


7.4 本 章 小 结 


本 章 实现 了 购物 车 的 显示 与 维护 、 订 单 的 提交 与 查看 。 本 章 的 程序 在 功能 上 和 逻辑 上 
都 要 比 前 面 的 章节 复杂 不 少 。 但 无 论 多 么 复杂 的 功能 , 也 都 是 由 一 些 最 基本 的 操作 实现 的 ， 
如 数据 库 的 增删 查 改 、 数 据 显示 、 表 单 提交 、 表 单 输出 、 表 单 验证 、 链 接 的 制作 和 Session 
的 读 写 等 。Grails 自动 生成 的 代码 就 是 针对 这 些 基 本 问题 ， 因 而 它 可 以 在 一 定 程度 上 实现 
部 分 需求 。 对 于 其 他 更 为 复杂 的 需求 ， 通 常 也 可 以 通过 修改 或 拼装 Grails 自动 生成 的 代码 
去 实现 。 因 此 ， 利 用 Grails 自动 生成 的 代码 ， 可 以 极 大 地 提高 开发 效率 。 修 改 Grails 自动 
生成 的 代码 ， 是 使 用 Grails 解决 实际 问题 的 一 个 基本 步骤 。 


系统 后 台 管理 
第 Bs 


本 章 将 开发 系统 后 台 管 理 相关 的 内 容 ， 包 括 对 商品 和 订单 信息 进行 管理 。 系 统 后 台 管 
理 需 要 安全 级 别 更 高 的 权限 管理 和 认证 机 制 。 本 章 不 讨论 权限 认证 与 分 配 相关 的 内 容 ， 
Grails 中 可 以 通过 Acegi、JSecurity 等 插件 实现 相关 功能 ， 它 们 会 在 第 16.3 节 进 行 介绍 。 
本 章 的 主要 知识 点 是 页 面 布局 的 技术 和 文件 上 传 。 

购物 车 系统 的 后 台 管理 ， 主 要 包括 商品 管理 和 订单 管理 。 后 台 管理 的 主要 功能 ， 实 际 
上 也 可 以 通过 Grails 自动 生成 CRUD 页 面 来 实现 。 这 里 需要 做 的 事情 主要 是 把 之 前 商品 和 
订单 相关 的 CRUD 功能 转移 到 后 台 ， 也 就 是 将 GoodsController 和 OrdersContoller 中 的 部 
分 action 转移 到 AdminController 下 ， 并 改 成 相应 的 命名 原则 ， 如 商品 的 list 方法 改 为 
listGoods， 订 单 的 list 方法 改 为 listOrders， 等 等 。 需 要 转移 的 方法 可 参照 如 下 : 

(1) goods.create 一 admin.createGoods; 

(2) goods.list 一 admin.listGoods; 

(3) goods.edit 一 admin.editGoods:; 

(4) orders.list 一 admin .listOrders; 

(5) orders.edit 一 admin.editOrders。 

其 中 ， 商 品 管理 的 具体 实现 可 以 参考 本 书 第 二 部 分 第 7 章 的 内 容 ， 订 单 管理 的 具体 实 
现 可 参考 7.3 购物 车 与 订单 的 内 容 。 

对 于 系统 的 后 台 管 理 ， 还 需要 为 其 单独 制作 一 个 区 别 于 前 台 页 面 的 导航 菜单 。 同 时 ， 
需要 实现 文件 上 传 的 功能 ， 人 允许 用 户 自由 上 传 商品 的 图 片 。 此 外 ， 对 于 订单 管理 ， 需 要 修 
改 订单 状态 ， 把 “未 发 货 ” 修 改 为 “已 发 货 *”。 这 3 部 分 的 内 容 ， 将 分 别 在 下 面 的 3 节 进 
行 介绍 。 


8.1 页 面 布局 的 使 用 


8.1.1 ”Grails Layout 的 基础 知识 


到 现在 ， 相 信 读 者 已 经 对 Grails 有 了 一 定 了 解 ， 在 它 自动 生成 的 页 面 基础 上 ， 可 以 实 
现 大 部 分 功能 。 但 是 ， 到 目前 为 止 ， 人 们 仍然 会 对 它 自动 生成 页 面 的 运行 效果 有 一 些 不 解 
之 处 。 例 如 ， 在 程序 的 每 个 页 面 ， 左 上 角 都 有 一 个 Grails 的 logo， 如 图 8-1 所 示 。 

但 事实 上 ， 在 views 的 普通 GSP 文件 中 ， 看 不 到 输出 logo 图 片 的 HIML 标签 。 之 所 
以 会 看 到 logo， 是 因为 Grails 使 用 了 一 种 页 面 布局 (layout) 的 机 制 ， 并 且 提 供 了 一 个 包含 


Grails logo 的 默认 layout 页 面 。Layout 机 制 使 得 不 同 的 页 面 能 够 使 用 相同 的 layout， 从 而 
在 多 个 页 面 中 得 到 一 致 或 相似 的 页 面 风 格 。 显 然 ， 使 用 layout 技术 ， 可 以 实现 对 UI 代码 
的 重用 ， 从 而 提高 开发 效率 和 程序 质量 。 


图 8-1 Grails 的 logo 


Grails 的 layout 技术 是 基于 成 熟 可 靠 的 SiteMesh 框架 实现 的 。 按照 SiteMesh 官方 的 说 
法 :“SiteMesh 是 一 个 网 页 布局 装饰 框架 和 网 页 应 用 集成 框架 ， 能 够 为 有 多 个 页 面 的 大 型 
网 站 构建 一 致 的 外 观 和 效果 ,相同 的 导航 和 布局 ”。 这 段 话 理解 起 来 可 能 有 些 抽象 ， 引 用 宣 
方 网 站 的 一 个 图 片 ， 可 以 很 好 地 解释 它 ， 如 图 8-2 所 示 。 


8-2 SiteMesh 的 作用 


图 8-2 可 以 分 为 3 部 分 ， 最 上 面 的 两 个 页 面 是 原始 页 面 ， 其 中 一 个 页 面 是 JSP， 另 一 
个 是 CGI 脚本 ; 中 间 是 一 个 装饰 器 (decorator)， 这 是 SiteMesh 的 核心 ; 最 下 面 的 两 个 页 
面 是 最 终 页 面 , 它 的 显示 内 容 是 用 decorator 装 饰 过 的 原始 页 面 ,拥有 一 致 的 布局 风格 。Grails 
的 layout 使 用 SiteMesh 框架 ， 通 过 定制 layout， 使 得 原始 的 GSP 页 面 在 经 过 decorator 装 
饰 之 后 ， 对 外 输出 具有 统一 风格 的 页 面 。 

理解 了 SiteMesh 的 工作 原理 之 后 ， 将 继续 介绍 如 何在 Grails 里 来 使 用 基于 SiteMesh 
框架 的 layout 技术 。 


在 Grails 的 目录 结构 里 ，decorator 默认 放置 在 grails-appWviews\layouts 目录 下 。 可 以 先 
看 一 个 典型 的 decorator 页 面 : 


从 上 面 的 代码 可 以 看 出 ，decorator 页 面 中 使 用 了 几 个 关键 的 Grails 标签 〈tag ): 
layoutHead、layoutTitle 和 layoutBody。 它 们 的 功能 分 别 为 : 


(1) layoutHead 一 一 向 目标 页 面 输出 原始 页 面 文档 头 head》 的 内 容 ; 
(2) layoutTitle 一 一 向 目标 页 面 输出 原始 页 面 标题 (title) 的 内 容 ， 

(3) layoutBody 一 一 向 目标 页 面 输出 原始 页 面 文档 主体 (body) 的 内 容 。 
接 下 来 继续 讨论 在 Grails 里 原始 页 面 如 何 与 decorator 页 面 进行 交互 。 


Grails 中 提供 了 简便 的 调用 decorator 的 方式 , 只 需 在 原始 页 面 里 添加 meta 标签 , 如 下 
面 的 例子 所 示 : 


通过 使 用 name 值 为 layout 的 meta 标签 ， 就 可 以 调用 decorator。 其 中 content 属性 的 
值 用 于 指定 decorator 的 文件 名 ( main 对 应 decorator 页 面 的 文件 名 是 
grails-app\views\layouts\main.gsp)。 在 使 用 了 上 述 的 meta 标签 后 ， 可 以 查看 输出 页 面 的 


HTML 代码 如 下 所 示 : 


8.1.2 为 系统 后 台 管 理 创 建 统一 的 decorator 


首先 ， 创 建 带 左 侧 导 航 的 decorator 页 面 (grails-app\views\layoutsvadmin.gsp ): 


斜体 部 分 的 代码 leftMenu div， 创 建 了 左 侧 的 菜单 栏 。 如 果 原 始 页 面 调用 了 admin.gsp， 
则 实际 显示 效果 如 图 8-3 所 示 。 


cpRiEs 


商品 管理 ja 入 omnes Bnet 


添加 商品 。 : Goods List 


订单 管理 ! 
新 订单 上 
已 发 货 订 单 
已 关闭 订单 


图 8-3 ”经 admin.gsp 装饰 后 页 面 含有 左 侧 菜 单 和 logo 


在 实际 的 应 用 中 ， 还 经 常会 遇 到 这 样 的 情况 ， 页 面 的 整体 布局 风格 是 一 致 的 ， 但 不 同 
的 栏目 有 不 同 的 二 级 导航 菜单 。 以 实际 最 常见 的 两 栏 结构 为 例 ， 若 二 级 菜单 栏 有 4 种 ， 如 
图 8-4 所 示 。 


图 8-4 不 同 模块 使 用 不 同 的 leftMenu， 但 整体 结构 相似 


如 果 对 每 种 不 同 的 二 级 导航 菜单 做 一 个 decorator, 那 就 需要 创建 4 个 相似 的 decorator。 
如 果 这 样 做 ， 会 出 现 大 量 的 重复 代码 ， 也 完全 违背 了 使 用 layout 技术 的 初衷。 

针对 这 样 的 需求 ， 应 该 考虑 将 menu 和 decorator 解 耦合 。 具 体 作 法 是 : 将 menu 内 容 
提取 出 来 , 创建 成 独立 的 template 页 面 ， 然 后 在 decorator 页 面 中 用 render 标签 对 其 内 容 进 
行 输出 回忆 一 下 购物 车 页 面 的 显示 ， 也 是 用 render 标签 输出 模板 ): 


创建 模板 \grails-app\views\admin\ adminMenu.gsp (再 次 注意 template 模板 文件 的 命名 
方式 ， 名 字 需 以 下 划 线 开始 )， 其 内 容 为 : 


使 用 render 模板 的 做 法 , 实现 了 decorator 与 实际 内 容 的 解 耦合 ,但 这 么 做 还 没有 完全 
解决 使 用 同一 decorator 显示 不 同 leftMenu 的 实际 需求 。 还 需要 实现 由 原始 页 向 decorator 
页 面 传递 具体 的 leftMenu 模板 的 名 称 。 

Grails 中 封装 了 SiteMesh 的 pageProperty 功能 , 被 装饰 页 面 (原始 页 ) 可 以 向 decorator 
传递 参数 。 而 decorator 页 面 可 以 通过 pageProperty 标签 读 取 内 容 。 因 而 ， 在 原始 页 面 中 可 
以 通过 参数 向 decorator (admin.gsp) 传 入 实际 的 leftMennu 模板 的 名 称 。 

对 于 上 面 的 例子 ， 需 要 在 原始 页 中 加 入 : 


其 中 ，name 属性 决定 了 参数 名 ， 而 content 属性 决定 了 参数 的 值 。 
在 decorator (admin.gsp) 中 ， 可 以 使 用 下 面 的 代码 读 取 参 数 的 内 容 (注意 参数 名 是 


相应 地 ， 要 根据 参数 的 内 容 输出 模板 页 面 ， 则 应 写成 : 


8.2 ”文件 上 传 的 实现 


8.2.1 开发 表单 页 面 


在 Web 应 用 中 ， 常 会 遇 到 文件 上 传 的 需求 。 例 如 ， 在 购物 车 的 应 用 中 ,管理 员 用 户 需 
要 为 商品 上 传 相应 的 图 片 。 本 节 将 讨论 如 何在 Grails 中 实现 文件 上 传 。 

在 处 理 上 传 文件 前 ， 需 要 先 创建 上 传 文件 的 表单 页 面 。 打 开 编辑 商品 的 GSP 页 面 
grails-app/views/admin/editGoods.gsp， 需 要 设置 如 下 代码 ， 这 里 仅 摘录 表单 相关 的 内 容 : 


关于 这 段 代 码 ， 需 要 注意 两 个 地 方 : 

(1) enctype 的 属性 设置 为 "multipart/form-data"; 
(2) input 的 type 属性 设置 为 file。 
表单 页 面 的 效果 如 图 8-5 所 示 。 
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图 8-5 编辑 商品 的 表单 〈 含 文件 上 传 ) 


8.2.2 在 Controller 中 接收 文件 


在 web-app 路 径 下 创建 名 字 为 “file” 的 文件 来, 该 文件 夹 将 用 于 保存 用 户 上 传 的 文件 。 
对 于 用 户 提交 的 文件 ， 通 常 不 能 直接 使 用 原始 名 称 保存 在 服务 器 的 硬盘 上 ， 因 为 这 样 将 很 
容易 引起 重 名 的 冲突 。 常 见 的 解决 办 法 是 用 随机 产生 的 字符 串 对 其 重新 命名 〈 通 常 还 要 保 
留 原来 的 扩展 名 )。 

接 下 来 ， 实 现 接收 上 述 表单 的 updateGoods action: 


上 面 的 updateGoods 操作 会 从 表单 请 求 中 读 取 上 传 文件 。 通 过 def f = 
request.getFile("savedFileName")， 可 读 取 上 传 的 文件 。 通 过 originalFilename 属性 可 以 获 
取 用 户 提交 的 文件 名 。 在 服务 器 端 保存 的 文件 命名 规则 为 “随机 数 + 原始 文件 扩展 名 ”， 然 
后 根据 该 规则 ， 使 用 transferTo 方法 将 所 上 传 的 文件 存储 到 服务 器 web-app\file 下 。 

在 这 里 ， 使 用 servletContext.getRealPath 得 到 web-app 文件 夹 在 硬盘 上 的 实际 存储 
路 径 。 
对 于 file 文 件 夹 中 的 文件 ,可 以 使 用 createLinkTo 取出 在 浏览 器 上 访问 该 文件 的 URL， 
最 后 将 goods 保存 到 数据 库 中 。createLinkTo 是 GSP 的 一 个 标签 ， 具体 的 使 用 方法 可 以 参 
考 第 14 章 。 


8.3 ”修改 订单 状态 


订单 的 管理 与 7.3 节 介绍 的 订单 查看 比较 相似 , 不 同 的 是 本 节 提供 将 订单 的 状态 从 “新 
订单 ” 改 为 “已 发 货 ”。 

首先 ， 为 订单 的 状态 制作 一 个 按钮 链接 ， 使 其 可 以 通过 单 击 该 按钮 修改 状态 。 在 
editOrders.gsp 下 添加 如 下 代码 : 


然后 ， 在 AdminController 里 添加 markAsShipped 方法 ， 把 指定 orders 的 status 改 为 
SHIPPED: 


实现 修改 订单 任务 ， 无 需 新 的 知识 点 ， 因 此 没有 做 详细 的 介绍 ， 读 者 可 以 参考 7.3 节 
的 实现 过 程 。 


8.4 本 章 小 结 


本 章 主要 实现 了 系统 的 后 台 管 理 ， 包 含 的 新 知识 点 有 : 如 何 使 用 layout 技术 实现 页 面 
代码 的 重用 ， 以 及 如 何在 Grails 中 进行 文件 上 传 。 到 目前 为 止 ， 购 物 车 应 用 的 基本 开发 暂 
时 告 一 段落 了 。 接 下 来 将 讨论 Grails 的 自动 化 测试 技术 。 


Grails 的 自动 化 测试 
第 9。 


本 书 的 第 二 部 分 设计 并 实现 了 一 个 购物 车 的 例子 ， 采 取 了 一 种 增 量 式 的 开发 方法 。 每 
一 次 增 量 实现 了 一 个 或 多 个 最 终 用 户 功能 ， 系 统 在 “ 渐 近 ”的 变化 过 程 中 不 断 完善 。 使 用 
这 样 的 开发 方法 ， 可 以 很 好 地 与 客户 交流 ， 可 以 及 时 地 进行 修改 和 调整 。 但 是 ， 这 样 的 开 
发 过 程 ， 还 算 不 上 是 真正 的 敏捷 开发 ， 原 因 是 测试 没有 跟 上 。 如 果 没 有 自动 化 测试 程序 作 
保证 ， 每 一 处 修改 都 有 可 能 给 系统 带 来 bug。 因 而 ， 从 这 一 点 上 来 讲 ， 自 动 化 测试 是 进行 
敏捷 开发 的 前 提 。 

Grails 对 自动 化 测试 框架 进行 了 很 好 的 集成 。 本 章 将 介绍 如 何 利用 Grails 集成 的 自动 
化 测试 框架 进行 测试 。 


9.1 ”Grails 自动 化 测试 基础 知识 


Grails 的 测试 是 基于 Groovy Test 框 架 的 ,而 Groovy Test 主 要 是 基于 JUnit 的 ,熟悉 JUnit 
的 读者 应 该 不 会 对 Grails 的 测试 感到 陌生 。 回 顾 第 二 章 ，Grails 创建 的 项 目 默认 将 自动 化 
测试 程序 〈test case) 放 到 test 文件 夹 。 而 test 文件 夹 中 又 包含 两 个 子 文 件 夹 ， 分 别 是 unit 
和 integration。 放 在 integration 文件 夹 中 的 test case 在 运行 时 需要 Grails 框架 “参与 ”， 因 
而 通常 用 于 测试 需要 Grails 框架 参与 的 场景 ， 如 数据 库 的 查询 与 更 新 等 。 放 在 unit 文件 夹 
中 的 test case 在 运行 时 不 需要 Grails 框架 的 参与 ,因而 通常 用 于 对 普通 的 Java 对 象 .Groovy 
对 象 进行 测试 。 

在 使 用 Grails 的 命令 创建 Domain 和 Controller 的 时 候 ，Grails 会 主动 创建 相应 的 test 
case。 当 然 ， 也 可 以 使 用 grails create-integration-test 命令 或 grails create-unit-test 去 创建 test 
case。 所 有 的 test case 都 是 GroovyTestCase 类 的 子 类 ， 表 现形 式 如 下 : 


class UserTests extends GroovyTestCase { 
void testSomething() { 


} 


可 以 在 TestCase 中 编写 多 个 名 为 testXXX 的 方法 , 每 一 个 testXXX 方法 都 相当 于 一 个 
测试 点 ， 都 会 被 Junit 测试 框架 调用 并 执行 测试 。GroovyTestCase 类 是 
junit framework.TestCase 的 子 类 ， 包含 了 大 量 的 断言 方法 ， 通 过 这 些 断 言 ， 可 以 对 程序 的 


运行 结果 进行 验证 ， 从 而 实现 自动 化 测试 ， 例 如 : 


上 面 的 例子 使 用 了 Grails 框架 提供 的 Domain 方法 ， 因 而 应 该 放 在 integration 文件 夹 
中 。 它 对 User 类 的 数据 验证 进行 了 测试 : 因为 User 类 的 属性 都 不 能 为 空 ， 所 以 它 的 保存 
不 能 成 功 ， 并 且 断 言 save 方法 会 返回 null; 同 理 ， 断 言 hasErrors 方法 返回 tue。 当 然 ， 也 
可 以 直接 使 用 groovy 的 assert 方法 进行 断言 , 具体 使 用 哪个 , 可 以 根据 自己 的 习惯 进行 选择 。 

Grails 中 使 用 grails test-app 命令 可 以 执行 测试 用 例 。 如 果 不 指定 测试 用 例 的 名 称 ， 则 
对 全 部 测试 用 例 进行 测试 ， 如 果 指 定名 称 ， 则 可 以 仅 执行 某 一 个 测试 用 例 。 测 试用 例 是 在 
test 环境 下 进行 的 〈 回 忆 一 下 前 面 配置 的 DataSource， 一 共有 3 种 环境 : development、test 
和 production)， 运 行 每 一 个 测试 用 例 之 前 ， 都 会 先 清空 测试 环境 的 数据 库 。 运 行 grails 
test-app， 可 能 会 看 到 如 下 的 输出 : 


同时 , Grails 还 会 生成 一 份 测试 结果 的 报告 ,存放 在 testreports 文件 夹 下 面 .打开 HTML 
格式 的 报告 文件 test/reports/html/index.html)， 可 以 看 到 非常 详细 的 测试 结果 ， 如 图 9-1 


所 示 。 


Unit Test Results 


Designed for use with JUnit and Ant. 


Note: failures are anticipated and checked for with assertions while errors are unanticipated. 


图 9-1 执行 测试 后 生成 的 报告 
9.2 ”编写 测试 用 例 


使 用 Grails 可 以 对 Domain、Service、Controller、Taglib (标签 库 ) 进行 测试 ， 接 下 来 
就 逐个 举例 讲解 。 


9.2.1 对 Domain 类 进行 测试 


由 于 Domain 类 中 对 数据 库 操作 的 方法 是 Grails 所 提供 的 ， 即 使 出 现 问 题 ， 普 通用 户 
也 难以 解决 。 因 此 ， 对 Domain 类 的 测试 重点 应 集中 在 对 自己 定义 的 方法 和 自己 定义 的 
validator 的 测试 。 就 本 书 购物 车 应 用 的 几 个 Domain 类 而 言 ， 主 要 应 对 Cart 类 的 totalPrice 
方法 ， 和 Orders 类 的 自 定义 validator 进行 测试 。 相 应 地 ， 对 Cart 的 测试 代码 如 下 : 


与 标准 的 Junit TestCase 类 似 ， 首 先 在 setUp 方法 中 写 一 些 初始 化 的 代码 。 这 里 创建 了 
相关 User、Cart、Lineltem、Goods、Category 的 记录 。 然 后 在 testTotalPrice 方法 中 ， 断 言 
cart.totalPrice0 的 返回 值 要 和 已 知 的 购物 车 中 商品 价格 总 和 相等 。 

在 这 个 test case 中 ,不 需要 编写 tearDown0 方 法 删除 数据 。 因为 Grails 会 自动 清空 test 
case 中 编写 的 保存 到 数据 库 中 的 数据 !, 这 样 就 不 用 考虑 残留 测试 数据 对 下 一 次 测试 带 来 的 
影响 ， 从 而 可 以 极 大 地 方便 编写 和 执行 test case。 

接 下 来 ， 对 Orders 类 的 自 定义 validator 进行 测试 。 


! Grails 进行 integration test 时 ,会 自动 在 每 个 test case 执行 完成 后 ， 提 交 到 数据 库 transaction 回 滚 ， 
从 而 避免 了 在 测试 时 产生 残留 数据 。 


OrdersTests 也 是 先 在 setUp 方法 中 创建 了 一 些 初始 数据 ， 不 同 的 是 ， 这 一 次 准备 了 两 
个 购物 车 ， 一 个 包含 两 件 商品 ， 另 一 个 不 包含 商品 。 然 后 在 testOrdersVerify 方法 中 创建 两 
个 orders， 分 别 对 应 两 个 购物 车 ， 调 用 validate 方法 ， 执 行 数据 验证 。 此 时 ， 引 用 空 购物 车 
的 orders 应 该 在 cart 字段 上 存在 错误 ， 同 时 ， 另 一 个 orders 在 cart 字段 上 没有 错误 。 


9.2.2 ”对 Service 类 进行 测试 


在 Grails 的 integration 测试 中 ,Service 类 的 实例 也 可 以 通过 Spring 的 IoC 容器 注入 到 
test case 中 ， 因 此 可 以 很 轻松 地 得 到 容器 中 的 实例 ， 从 而 测试 变 得 更 加 容易 : 


接 下 来 开发 用 于 测试 保存 订单 的 test case。 这 个 用 例 在 执行 失败 时 会 抛 出 异常 ， 这 里 
可 以 使 用 shouldFail 方法 来 进行 断言 。shouldFail 方法 要 求 传 入 一 个 闭 包 ， 若 闭 包 在 执行 有 
异常 抛 出 时 ， 则 测试 成 功 ， 否 则 测试 失败 。TestCase 和 程序 代码 如 下 : 


9.2.3 对 Controller 进行 测试 


从 效果 上 来 说 ， 对 Controller 进行 测试 是 最 有 实际 价值 的 。 因 为 Controller 最 能 体现 出 
程序 与 需求 中 每 个 功能 点 的 对 应 关系 ， 也 最 能 体现 出 系统 与 用 户 的 交互 操作 。 然 而 ， 在 
Grails 中 ， 对 Controller 进行 测试 ， 并 不 是 在 模拟 浏览 器 的 请 求 ， 而 是 通过 创建 模拟 对 象 
(Mock)， 使 Controller 运行 在 某 些 特定 的 环境 参数 下 〈 如 特定 的 URL 参数 、 表 单 参数 、 
Session 等 )， 然 后 验证 Controller 执行 后 对 环境 产生 的 输出 〈 如 跳 转 、 对 Session 的 修改 、 
返回 给 GSP 的 model 等 )。 

这 里 不 对 每 一 个 Controller 的 每 一 个 action 都 进行 测试 ， 只 选取 几 个 比较 典型 的 action 
进行 介绍 。 首 先 ， 对 UserController 的 loginCheck 进行 测试 ， 以 测试 登录 的 验证 逻辑 是 否 
正确 。 


Ep 


UserControllerTests 包含 两 个 测试 点 , 分 别 对 应 登录 成 功 和 登录 失败 的 两 个 场景 。 通过 
修改 Controller 实例 的 params 属性 的 值 ， 可 以 模拟 通过 表单 向 Controller 提交 数据 。 然 后 
调用 action， 并 在 action 执行 完毕 后 ， 校 验 此 时 要 跳 转 到 的 目标 URL 和 session 的 内 容 。 

如 果 action 中 使 用 了 CommandObject， 仍 然 可 以 使 用 params 属性 去 指定 参数 。 例 如 ， 
对 注册 逻辑 进行 测试 : 


如 果 Controller 中 使 用 了 Service， 则 在 test case 中 需要 为 Controller 的 Service 进行 初 
始 化 。 道理 很 简单 ， 用 new 创建 Controller, 不 存在 于 Spring 容器 中 ， 因 而 也 不 会 被 Spring 
所 初始 化 。 

要 初始 化 Controller 中 的 Service， 其 实 是 很 容易 的 ， 只 需要 在 test case 中 定义 对 应 的 
Service 属性 。 从 上 一 小 节 可 以 知道 ，Spring 容器 会 为 test case 注入 Service， 因 而 将 Spring 
容器 中 的 Service 实例 手动 注入 Controller 即 可 。 例 如 ， 对 OrdersController 进行 测试 : 


下 一 个 例子 将 讨论 如 何 验 证 action 向 GSP 传递 的 Model 数据 , 这 对 于 查询 类 的 业务 是 
很 有 实用 价值 的 。 


通过 前 面 章节 的 学 习 可 以 知道 ，Controller 向 GSP 传递 数据 有 两 种 方式 : 一 种 是 使 用 
action 的 返回 值 , 此 时 action 的 返回 值 将 传递 给 与 之 同名 的 GSP 页 面 ; 另 一 种 是 使 用 render 
方法 ， 通 过 View 指定 GSP 页 面 ， 通 过 Model 指定 要 传递 的 数据 。 如 果 是 用 第 一 种 方式 向 
页 面 传递 数据 ， 那 么 毫 无 疑问 ， 通 过 action 的 返回 值 即 可 得 到 相应 的 数据 ; 如果 是 使 用 第 
二 种 方式 ， 通 过 访问 Controller 的 modelAndView 属性 ， 即 可 得 到 Model 和 View 的 信息 。 


这 里 要 补充 说 明 一 点 ， 在 测试 时 调用 Controller 的 action， 并 不 会 触发 Controller 的 拦 
截 器 inteceptor， 也 不 会 触发 flter。 如 果 需 要 对 它们 进行 测试 , 用户 需要 在 test case 中 手动 
调用 Controller 拦截 器 或 filter 的 闭 包 。 


9.2.4 对 Taglib 进行 测试 


虽然 读者 还 没有 学 习 如 何 自己 定义 标签 ， 但 至 少 可 以 对 Grails 已 经 提供 的 标签 进行 测 
试 。Grails 提供 了 一 个 名 为 GroovyPagesTestCase 的 类 ， 通 过 它 可 以 轻松 地 对 标签 库 进 行 测 


试 。 相 应 地 ，test case 也 不 再 继承 于 GroovyTestCase， 而 是 继承 GroovyPagesTestCase。 
GroovyPagesTestCase 类 提供 了 两 个 实用 的 方法 : applyTemplate 和 assertOutputEquals。 

applyTemplate 有 两 个 参数 : 第 一 个 参数 为 标签 的 内 容 ， 如 “<glink 
action="show">show</g:link>”， 第 二 个 参数 为 要 传 入 的 数据 ， 是 一 个 map〔 回 忆 一 下 上 一 
章 介 绍 的 render 标签 )。 具 体 使 用 如 下 : 


assertOutputEquals 有 4 个 参数 : 第 一 个 参数 为 预期 的 输出 ; 第 二 个 参数 和 第 三 个 参数 
分 别 与 applyTemplate 的 第 一 个 参数 和 第 二 个 参数 相同 ; 第 四 个 参数 为 可 选 , 要求 传 入 一 个 
闭 包 ， 以 实现 对 输出 进行 格式 处 理 。 具 体 使 用 如 下 : 


9.3 ”本 章 小 结 


本 章 从 自动 化 测试 的 基础 知识 开始 入 手 , 结合 实例 , 分 别 介绍 了 使 用 Grails 对 Domain、 
Service、Controller、Taglib 等 进行 测试 的 方法 。 通 过 本 章 的 学 习 ， 读 者 可 以 自行 开发 自动 
化 的 测试 程序 ， 进 而 实现 测试 驱动 的 开发 。 读 者 通过 学 习 本 章 的 内 容 ， 有 利于 养 成 良好 的 
开发 习惯 ， 从 而 开发 出 质量 更 高 的 应 用 程序 。 


‘| Os 


中 使 
因此 


使 用 Grails 开发 的 网 站 ， 最 终 都 要 部 署 在 生产 环境 中 。 人 们 当然 不 会 希望 在 生产 环境 
grails run-app 命令 去 执行 程序 ,通常 也 不 会 选用 Grails 自 带 的 Jetty 作为 Web Server。 
， 本 章 讨论 如 何 将 Grails 的 应 用 程序 部 署 到 生产 环境 中 。 


10.1 ”Grails 对 部 署 的 支持 


示 在 


Grails 的 run-app 命令 实际 上 是 可 以 使 用 运行 环境 参数 的 。 例 如 ，grails prod run-app 表 
生产 环境 运行 。 此 时 , 程序 的 性 能 会 有 一 定 的 提高 , 但 仍然 是 使 用 Jetty 作为 Web Server 


运行 的 。 如 果 部 署 在 Tomcat 这 样 的 Web Server 下 ，Web 应 用 的 性 能 还 会 有 很 大 的 提升 。 
因此 ， 在 真正 的 生产 环境 中 ， 应 选择 更 为 专业 的 Web Server 进行 部 署 。 使 用 grails prod 
run-app 运行 程序 更 多 是 帮助 程序 开发 人 员 重 现 生产 环境 中 发 现 的 bug: 如 果 在 开发 模式 下 
bug 不 能 被 重 现 ， 可 以 尝试 在 生产 模式 下 运行 。 


Web 


Grails 对 部 署 提 供 了 很 好 的 支持 , 可 以 使 用 war 命令 创建 Web 应 用 的 war 包 。 了 解 Java 
开发 的 人 一 定 不 会 对 war 包 陌 生 。 通 过 标准 的 war 包 ， 可 以 很 容易 地 将 Grails 的 应 用 


部 署 到 Tomcat、JBoss、GlassFish、WebSphere 等 开源 或 商用 的 应 用 程序 服务 器 中 。 


首先 ， 运 行 grails war 命令 。 
>grails war 


Welcome to Grails 1.0.4 - http://grails.org/ 
Licensed under Apache Standard License 2.0 


Grails home is set to: D:\grails-1.0.4 


Base Directory: D:\workspace\GDepot 


[mkdir] Created dir: D:\workspace\GDepot\staging\WEB-INF\plugins 
[copy] Warning: D:\workspace\GDepot\plugins not found. 
[jar] Building jar: D:\workspace\GDepot\GDepot-0.1.war 
[delete] Deleting directory D:\workspace\GDepot\staging 
Done creating WAR D:\workspace\GDepot/GDepot-0.1.war 


命令 的 执行 需要 几 秘 钟 的 时 间 。 命 令 执 行 完毕 后 ， 会 生成 一 个 名 为 GDepot-0.1.war 的 
文件 ， 这 个 文件 就 是 包含 了 全 部 GDepot 应 用 程序 的 war 包 。 如 果 想 修改 war 包 的 版 本 号 ， 
可 以 修改 项 目 根 目 录 下 的 application properties 文件 。 如 果 想 指定 默认 的 war 包 文件 名 ， 可 
以 在 Config.groovy 文件 中 加 入 一 行 : 


要 将 war 包 部 署 到 应 用 程序 服务 器 下 面 , 是 很 容易 的 事情 。 对 于 Tomcat, 有 两 种 方式 : 
一 种 是 将 war 文件 保存 到 Tomcat 安装 目录 的 webapps 目录 下 ， 然 后 重启 Tomcat， 会 发 现 
Tomcat 将 自动 把 war 包 解 压 ， 并 且 运 行 应 用 ; 另 一 种 方式 是 使 用 Tomcat 的 管理 控制 台 ， 
在 浏览 器 输入 http://localhost:8080/manager/html， 然 后 在 Deploy 区 域 选择 本 机 的 war 包 ， 
或 者 上 传 war 包 ， 然 后 单 击 Deploy 按钮 ， 这 样 就 可 以 实现 在 远程 计算 机 上 部 署 war 包 了 ， 


如 图 10-1 所 示 。 
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图 10-1 使 用 Tomcat 管理 控制 台 部 署 


对 于 其 他 更 高 级 的 应 用 服务 器 ， 部 署 方式 也 是 类 似 的 。 引 用 Grails 官方 的 数据 ，Grails 
在 不 同 应 用 服务 器 的 部 署 测 试 结 果 如 表 10-1 所 示 。 


表 10-1 Grails 对 Web Container 的 兼容 情况 
co co 
Tomcat 5.5 Y 
Tomcat 6.0 本 
Geronimo 2.0.2 Unknown. but see WAS CE below 
Geronimo 2.1.1 
GlassFish v1 (Sun AS 9.0) 
GlassFish v2 (Sun AS 9.1) 
GlassFish v3 
Sun App Server 8.2 
Websphere 6.1 
Websphere Application Server Community Edition 2.0 
(WAS CE) 
Resin 3.2 
Oracle AS 
JBoss 4.2 
Jetty 6.1 
SpringSource Application Platform 1.0 beta 
Weblogic 8.1.2 
Weblogic 10 
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10.2 配置 应 用 程序 


虽然 Grails 努力 追求 的 目标 是 零 配置 ， 但 理想 总 是 与 现实 存在 一 定 差距 。 首 先 ， 数 据 
库 的 配置 就 是 不 可 避免 的 。 在 第 2 章 已 经 介绍 过 ， 修 改 DateSource.groovy 的 内 容 ， 可 以 配 
置 数据 库 的 连接 方式 。 但 对 于 部 署 在 生产 环境 下 的 应 用 而 言 ， 这 里 就 可 能 存在 一 个 问题 。 

通常 情况 下 ， 负 责 开发 项 目的 和 部 署 项 目的 可 能 不 是 同一 个 人 ， 而 且 很 有 可 能 不 允许 
程序 开发 人 员 直 接 访问 生产 环境 的 数据 库 ， 即 生产 环境 的 数据 库 所 使 用 的 用 户 名 和 密码 对 
开发 人 员 是 保密 的 。 在 这 种 情况 下 ， 就 需要 由 部 署 人 员 去 配置 程序 的 数据 库 连 接 信息 。 但 
是 ， 从 Grails 打包 的 war 包 中 可 以 看 到 ，DataSource.groovy 文件 已 经 被 编译 成 了 一 个 Java 
的 字 节 码 文件 (class 文件 )， 如 图 10-2 所 示 。 因 此 ， 修 改 DataSource.groovy 已 经 不 是 一 件 
容易 的 事情 了 。 

要 解决 这 个 问题 ， 有 以 下 几 种 思路 。 


大 部 分 的 J2EE 应 用 服务 器 都 提供 了 完善 的 数据 库 连接 池 支 持 。 应 用 程序 可 以 通过 
JNDI 使 用 由 服务 器 提供 的 数据 库 连 接 池 。 在 Grails 中 ， 访 问 INDI 数据 源 非常 简单 ， 只 需 
要 指定 dataSource 的 jndiName 属性 即 可 ， 此 时 DataSource.groovy 应 写成 如 下 样式 : 


DataSource$_run_closurel.class 
DataSsource$_run_closure2.class 
DataSsource$_run_closure3.class 

图 Datasource$_run_closure3_closure4.class 
DataSource$_run_closure3_closure4_ closure7.class 
DataSource$_run_closure3_closure5.class 
DataSource$_run_closure3_closure5_closure8.class 
DataSource$ run_closure3_closure6.class 
DataSource$ run_closure3_closure6 closure9.class 


图 10-2 DataSource 被 编译 成 了 Java 字 节 码 


此 时 jndiName 的 取 值 取决 于 应 用 服务 器 的 配置 ,相应 地 对 数据 库 的 访问 控制 (用 户 名 、 
密码 ) 也 只 需要 在 应 用 服务 器 上 进行 配置 ， 即 Grails 已 不 再 管理 数据 库 的 连接 。 例 如 ， 在 
Tomcat 下 ， 需 要 通过 在 serverxml 中 加 入 如 下 配置 代码 : 


不 同 应 用 服务 器 下 配置 数据 源 的 方法 并 不 相同 ， 但 基本 原理 相似 ， 可 以 参考 不 同 的 服 
务 器 的 文档 进行 配置 。 


Grails 中 有 一 个 读 取 内 部 或 外 部 配置 文件 的 统一 入 口 。Config.groovy 中 包含 了 大 量 的 
配置 项 ， 其 中 一 项 是 默认 注释 掉 了 的 grails.config.locations 选项 ,通过 该 选项 , 可 以 实现 从 
外 部 配置 文件 中 读 取 配 置信 息 。 


它 默 认 支 持 两 种 文件 查找 方式 : 一 种 是 以 当前 的 classpath 为 根 目录 , 去 查找 配置 文件 ; 
另 一 种 是 通过 文件 系统 的 绝对 路 径 ， 去 查找 配置 文件 。grails.config locations 是 一 个 list， 
因而 可 以 一 次 指定 多 个 外 部 配置 文件 。 可 以 在 外 部 配置 文件 中 配置 与 DataSource 相关 的 内 
容 。Grails 会 聪明 地 使 用 外 部 配置 文件 里 的 配置 信息 ， 覆 盖 DataSource.groovy 中 配置 的 
信息 。 

首先 将 Config.groovy 中 的 grails.configlocations 定义 为 grails.config.locations = 
["classpath:datasource.properties"]。 此 时 ，Grails 会 从 classpath 中 寻找 datasource properties 
文件 ， 然 后 在 grails-app\conf 文件 夹 下 ， 创 建 datasource.properties 文件 !。 在 其 中 添加 如 下 
内 容 : 


1 Grails 在 生成 war 包 时 ， 会 自动 将 所 有 Groovy 文件 或 Java 文件 编译 成 Java 字 节 码 (class 文件 )， 
其 他 与 Groovy 或 Java 在 同一 文件 夹 下 的 文件 ， 则 被 复制 到 WEB-INF\classes 中 ， 即 运行 时 的 classpath。 


ss 


这 里 读者 可 以 亲自 体会 一 下 properties 文件 中 的 每 一 个 配置 项 与 DataSource.groovy 中 
的 配置 项 的 对 应 关系 。 

将 配置 信息 写 入 到 properties 文件 中 ， 就 不 存在 因为 被 编译 而 无 法 进行 修改 的 问题 了 。 
当然 ， 如 果 是 将 properties 存放 到 classpath 中 ， 则 每 次 更 新 war 包 都 可 能 需要 重新 配置 数 
据 库 。 系 统管 理 员 可 以 事先 与 开发 人 员 约定 好 ， 将 数据 库 的 配置 文件 存放 到 硬盘 的 某 一 固 
定 目录 下 ， 然 后 开发 人 员 在 配置 grails.config.locations 时 ， 使 用 绝对 路 径 去 指定 配置 文件 。 

需要 补充 说 明 的 是 ， 外 部 配置 文件 中 不 仅 可 以 编写 数据 库 的 配置 信息 ， 还 可 以 根据 项 
目的 需要 ， 定 义 其 他 信息 ， 如 文件 上 传 路 径 等 。Grails 提供 了 简单 易 用 的 读 取 配 置 文件 的 
方法 ， 例 如 ， 在 配置 文件 中 定义 了 如 下 内 容 : 


~ app-uploadpath=/var/www/Gdepot/upload 
则 可 以 在 Controller 中 使 用 如 下 代码 去 读 取 配 置 文件 的 内 容 : 
aef path = grailsApplication.config.app.uploadpath 


其 中 , grailsApplication 是 Controller 的 一 个 属性 (与 Service 对 象 一 样 , grailsApplication 
是 Spring 注入 到 Controller 中 的 )。 

如 果 想 在 Controller 以 外 的 其 他 地 方 读 取 配置 信息 ， 则 可 以 使 用 ConfigurationHolder 
类 的 静态 属性 config， 如 : 


10.3 ”本 章 小 结 


本 章 从 实用 的 角度 ， 对 部 署 Grails 应 用 的 方法 进行 了 介绍 。Grails 本 身 对 部 署 提供 了 
很 好 的 支持 。 可 以 通过 grails war 命令 ,自动 生成 war 包 。 使 用 标准 的 war 包 可 以 很 容易 地 
将 应 用 程序 部 署 在 主流 的 Web Server 上 。 此 外 ， 本 章 还 介绍 了 在 Grails 中 使 用 外 部 配置 文 
件 的 方法 。 由 系统 管理 员 编写 生产 环境 配置 信息 ， 在 现实 中 比较 常见 。 对 于 这 种 情况 ， 使 
用 外 部 配置 文件 显得 更 加 实用 。 


深入 了 解 Grails 


通过 前 面 两 部 分 的 学 习 ， 相 信 读 者 一 定 已 经 对 Grails 有 了 一 定 的 了 解 ， 也 
能 够 使 用 Grails 去 开发 Web 应 用 了 。 但 是 ， 前 面 开发 的 例子 多 少 都 有 一 些 理想 
化 的 成 分 ， 例 如 : 使 用 Grails 自动 生成 的 数据 库 ， 不 关心 程序 的 性 能 。 在 这 一 
部 分 将 对 Grails 的 一 些 细 节 进 行 更 深入 的 讨论 ， 以 解决 更 多 更 实际 和 复杂 的 
问题 。 


a||, | 


Grails 本 质 上 是 通过 Hibernate 进行 数据 库 操作 的 ， 并 且 进 一 步 地 用 Groovy 语言 对 
Hibernate 进行 了 新 的 封装 。 封 装 后 的 框架 还 有 一 个 很 好 的 名 字 , 叫 GORM。 前 面 的 章节 已 
经 对 GORM 进行 了 一 定 的 介绍 , 如 list、get、delete、findBy* 等 方法 , 以 及 HibernateCriteria 
Builder。 本章 将 对 GORM 的 一 些 高 级 特性 进行 较 深入 的 讨论 。 本章 的 部 分 内 容 需 要 一 定 的 
Hibernate 背景 知识 (文中 也 提供 了 一 些 参考 文档 的 URL， 供 读者 查阅 )。 


11.1 自 定义 映射 


进行 数据 库 开 发 的 一 个 很 现实 的 问题 就 是 ， 不 可 能 完全 由 Grails 去 生成 数据 库 的 表 结 
构 。 通 常情 况 下 ， 一 些 有 经 验 且 有 发 言 权 〈 通 常 是 比较 年 长 ) 的 技术 经 理 ， 更 希望 亲自 进 
行 数据 库 的 设计 。 另 一 方面 ， 如 果 是 升级 老 系统 ， 完 全 重建 数据 库 也 是 不 现实 的 。 因 此 ， 
如 果 GORM 想 要 真正 地 被 广泛 使 用 , 一 定 要 能 够 被 映射 到 已 有 数据 库 表 上 。 这 就 是 所 谓 的 
自 定义 映射 。 


11.1.1 基本 映射 


自 0.6 版 开始 ，GORM 的 自 定义 映射 的 功能 得 到 了 巨大 的 改进 ， 并 演化 成 为 一 种 可 以 
配置 表 、 字 段 、 缓 存 等 的 DSL。 有 具体 进行 映射 其 实 非常 简单 : 通过 mapping 闭 包 ， 就 可 以 
添加 自 定义 的 配置 信息 。 

首先 ， 对 表 名 和 字段 名 进行 映射 配置 。 


class Order { 
string receiverName 
Cart cart 
static mapping = { 
table 'orders' 
recevierName column:'Receiver Name' 


cart column: "cart_ id' 


在 mapping 闭 包 中 ， 使 用 “table ' 表 名 '”， 可 以 配置 Domain 类 对 应 的 表 名 。 使 用 “ 属 
性 名 column: ' 字 段 名 ”， 可 以 配置 Domain 类 中 某 一 属性 ， 及 其 对 应 的 数据 库 中 的 字段 名 。 
如 果 是 与 其 他 表 关 联 的 属性 ， 则 字段 名 为 相应 的 外 键 字段 。 

对 于 字段 而 言 ， 除 了 可 以 指定 名 称 ， 还 可 以 指定 类 型 〈 这 个 更 多 用 于 让 GORM 自动 
创建 表 )。 


“属性 名 type: ' 类 型 名 '” 可 以 为 Domain 类 的 属性 指定 数据 库 中 对 应 的 字段 数据 类 型 。 
其 中 可 选 的 数据 类 型 包括 基本 类 型 与 自 定义 类 型 两 大 类 ， 如 表 11-1 所 示 。 


表 11-1 基本 类 型 与 自 定义 类 型 


基本 类 型 integer, long, short, float, double, character, byte, boolean, yes_no. true_false 
string, text 
date, time. timestamp 
clob. blob. binary 

自 定义 类 型 。 实现 了 org.hibernate.usertype.UserType 接口 的 类 


更 多 关于 自 定义 类 型 的 内 容 , 可 以 参考 Hibernate 的 参考 文档 : http://www.hibernate.org/ 
hib_docs/core/reference/en/html/mapping.html 


11.1.2 ”配置 主键 


mapping 闭 包 中 还 可 以 定义 数据 库 的 主键 。 默 认 情况 下 ，GORM 会 为 每 个 Domain 添 
加 一 个 默认 id， 同 时 在 数据 库 表 中 创建 一 个 自 增 型 的 id 字段 作为 主键 。 通 过 下 面 的 代码 ， 
可 以 自己 指定 主键 的 字段 名 : 


还 可 以 通过 mapping 闭 包 指定 主键 的 生成 策略 。 下 面 的 代码 展示 了 使 用 hilo 算法 的 主 
键 生成 策略 (需要 额外 在 数据 库 中 创建 i_value 表 ， 该 表 必需 包含 next_value 字段 ): 


笔者 推荐 使 用 uuid 方式 生成 主键 : 


uuid 相 比 于 其 他 的 主键 生成 策略 ， 有 一 个 显著 的 优势 ， 那 就 是 主键 的 生成 过 程 无 需 与 
数据 库 交 互 。 这 在 出 现 高 并 发 数据 库 写 入 时 ， 会 有 较 明 显 的 性 能 优势 。 

除了 hilo 和 uuid 以 外 ，Hibermate 还 提供 了 多 种 主键 生成 策略 ， 可 以 参考 Hibernate 的 
官方 网 站 去 了 解 相 关内 容 外 。 

现在 业内 流行 的 数据 库 设计 理念 , 不 再 推荐 使 用 业务 主键 (业务 相关 的 字段 作为 主键 ， 
如 学 号 、 身 份 证 号 、ISBN 等 )， 而 推荐 使 用 逻辑 主键 (业务 无 关 的 字段 作为 主键 )。 原 因 
是 业务 主键 使 用 了 业务 数据 ， 而 业务 相关 的 数据 是 无 法 保证 不 会 发 生变 化 的 (例如 ， 电 话 
号 码 、 学 号 、 身 份 证 号 、ISBN 都 是 有 可 能 升 位 、 改 格式 等 的 )， 而 一 旦 发 生变 化 ， 则 意味 
着 大 量 级 联 更 新 ， 代 价 无 疑 是 巨大 的 '。 但 是 ， 对 于 老 系统 ， 多 多 少 少 可 能 已 经 使 用 了 业务 
主键 ， 并 且 相 当 一 部 分 遗留 系统 中 可 能 还 使 用 了 复合 主键 。 为 了 实现 对 遗留 系统 的 兼容 ， 
GORM 也 对 复合 主键 提供 了 支持 : 


对 于 使 用 复合 键 的 Domain 类 ， 应 注意 以 下 两 点 。 

(1) 使 用 复合 键 的 Domain 类 ， 必 有 需 实现 Serializable 接口 。 

(2) 使 用 主键 从 数据 库 中 读 取 Domain 实例 〈get 方法 )， 可 使 用 该 类 型 对 象 的 原型 实 
例 〈 主 键 包 含 的 字段 不 为 空 的 实例 ) 作为 get 方法 的 参数 ， 例 如 ， 从 数据 库 取出 名 为 张 三 
的 Student: 


1 可 以 想象 ， 有 海量 数据 的 图 书 系统 ， 如 果 ISBN 作为 主键 ， 一 旦 ISBN 要 统一 升 位 ， 几 乎 所 有 的 数 
据 库 表 都 会 受到 影响 ， 产 生 的 级 联 更 新 操作 将 带 来 多 么 巨大 的 开销 ! 


当然 ， 如 果 不 是 为 了 兼容 遗留 系统 的 数据 库 ， 不 推荐 使 用 业务 主键 ， 更 强烈 不 推荐 使 
用 复合 主键 。 


11.1.3 “ 锁 ” 与 Version 


GORM 默认 情况 下 将 Domain 配置 为 使 用 乐观 锁 (optimistic locking)， 乐 观 锁 是 
Hibernate 提供 的 一 个 特性 : 在 数据 库 表 中 添加 version 字段 并 在 Domain 类 中 添加 version 
属性 ， 通 过 version 记录 数据 被 更 新 的 次 数 。 如 果 在 执行 更 新 时 发 现 当前 对 象 的 version 值 
与 数据 库 中 的 version 字段 内 容 不 一 致 ， 则 会 抛 出 异常 (org.hibermate.StaleObject 
StateException)。 以 下 面 的 代码 为 例 : 


虽然 乐观 锁 能 提供 不 错 的 执行 性 能 , 但 在 一 些 情况 下 它 并 不 适用 , 例如 像 上 面 的 代码 ， 
需要 用 悲观 锁 (pessimistic locking) 去 解决 问题 。GORM 提供 了 lock 方法 去 使 用 悲观 锁 : 


多 线程 环境 会 给 开发 人 员 增 加 不 少 的 负担 。 上 面 的 代码 只 能 保证 程序 在 lock 和 save 
之 间 执行 的 时 候 ，goods 的 内 容 不 会 被 其 他 线程 修改 。 因 此 更 严格 的 做 法 是 直接 用 lock 方 
法 去 读 取 数 据 ， 而 不 是 用 get 方法 : 


一 旦 事务 提交 ， 翡 观 锁 的 使 命 就 完成 了 ，Grails 会 自动 将 其 释放 。 由 于 本 质 上 悲观 锁 
是 通过 SQL 语句 SELECT FOR UPDATE 对 数据 库 中 的 记录 进行 锁 操作 ， 对 于 不 支持 悲观 
锁 的 数据 库 (如 Grails 自 带 的 嵌入 式 数 据 库 HSQLDB)，lock 方法 可 能 不 能 正确 执行 ， 所 
以 使 用 前 需要 先 确定 所 选择 的 数据 库 是 支持 翡 观 锁 的 。 

在 映射 没有 version 字段 遗留 数据 库 时 ， 可 通过 mapping 闭 包 禁 用 version 字段 : 


11.1.4 事件 与 自动 时 间 戳 


有 的 时 候 会 存在 这 样 的 需求 : 在 删除 XXX 之 前 , 要 先 对 XXX 进行 XXX 操作 。GORM 
给 程序 员 提供 了 事件 机 制 ， 可 以 分 别 在 插入 前 、 更 新 前 、 删 除 前 、 载 入 后 触发 并 执行 ， 如 
表 11-2 所 示 。 


表 11-2 GORM 中 可 触发 的 事件 


插入 前 触发 def beforeInsert = { 
/do something before insert 
} 

更 新 前 触发 def beforeUpdate = { 
/do something before update 
} 

删除 前 触发 def beforeDelete = { 
/do something before delete 
} 

载 入 后 触发 def onLoad={ 


/do something after loaded 
} 


如 在 Domain 中 定义 了 名 为 lastUpdated 或 dateCreated 的 属性 ， 则 GORM 会 自动 在 更 
新 或 插入 时 更 新 这 两 个 属性 的 值 , 而 无 需 程序 员 在 beforeInsert 和 beforeUpdate 这 两 个 事件 
中 去 手动 更 新 。 但 如 果 不 希 望 GORM 自动 做 这 件 事情 , 则 应 该 在 mapping 闭 包 中 禁用 自动 
时 间 惟 : 


11.1.5 ”映射 Blob 字段 


Blob 类 型 的 字段 在 数据 库 中 是 比较 特殊 的 字段 ， 用 于 在 数据 库 中 存储 二 进 制 的 文件 。 
但 Blob 类 型 的 字段 使 用 通常 较为 特殊 ， 不 同 的 数据 库 对 其 支持 也 往往 不 全 相同 。 因 此 , 通 
常情 况 下 使 用 数据 库 中 Blob 类 型 的 字段 并 不 容易 。 


然而 ，GORM 中 对 Blob 类 型 的 字段 ， 提 供 了 强大 的 支持 ， 其 使 用 过 程 也 是 难以 置信 
的 简单 ， 只 需 在 Domain 中 将 该 类 型 的 字段 定义 为 Byte[] (此 时 的 数据 库 表 可 能 需要 手动 
修改 ， 本 文 以 下 代码 将 photo 字段 手动 改 成 MySQL 的 LongBlob 类 型 ， 以 支持 长 度 较 大 的 
文件 ): 


相应 地 ， 将 上 传 文件 写 入 数据 库 的 Controller action， 可 以 为 如 下 样式 : 


很 简单 ， 不 是 吗 ? 还 是 使 用 save 方法 ， 就 可 以 将 文件 保存 到 数据 库 中 ,过程 与 普通 的 
Domain 没有 任何 区 别 。 
相应 地 ， 将 数据 库 中 的 文件 取出 ， 并 且 输 出 到 浏览 器 显示 的 代码 也 很 简单 : 


由 于 不 同 数据 库 厂商 提供 的 Blob 字段 不 全 相同 , 本 文 也 无 法 保证 上 面 的 代码 在 所 有 的 
数据 库 上 都 能 正常 运行 ， 仅 在 MySQL 与 Microsoft SQL Server 2005 (SQL Server 中 的 字段 
类 型 为 image) 下 测试 并 通过 ， 其 他 的 数据 库 笔者 暂时 没有 条 件 测试 ， 欢 迎 感 兴趣 的 读者 
测试 并 共享 测试 结果 。 


11.1.6 ”定义 非 持久 化 属性 


前 面 介 绍 的 Domain， 其 每 个 属性 都 是 与 数据 库 表 中 的 字段 相对 应 的 。 然 而 ， 有 时 人 们 
会 希望 在 Domain 中 定义 一 些 不 被 数据 库 保存 的 字段 。 例 如 ， 用 户 注册 时 ， 需 要 用 户 输入 
两 遍 密 码 , 但 数据 库 中 只 需 保存 其 中 的 一 遍 。 回忆 一 下 第 6.2 节 , 它 是 通过 CommandObject 
实现 的 提交 两 次 密码 并 验证 是 否 相同 。 如 果 能 够 在 Domain 中 声明 某 一 属性 无 需 保存 到 数 
据 库 中 ， 则 程序 会 得 到 明显 的 简化 。 

GORM 提供 了 static 属性 transients， 用 于 定义 多 个 无 需 持久 化 的 属性 ， 如 果 使 用 
transients， 则 User Domain 应 该 写 为 如 下 的 形式 : 


此 时 ， 无 需 CommandObject 就 可 以 实现 用 户 注册 中 的 “两 次 密码 必需 一 致 ”的 校 验 逻 
辑 了 。 


11.2 ”深入 理解 Domain 间 的 关系 


11.2.1 一 对 一 关系 


一 对 一 关系 在 关系 数据 库 中 属于 最 简单 的 情况 。 相 应 地 ， 在 Grails 中 是 两 个 Domain 
类 通过 属性 互相 进行 引用 (可 以 是 双向 的 ， 也 可 以 是 单 向 的 )。 


此 时 ，Car 和 Engine 是 一 对 一 的 关系 ， 并 且 是 单 向 的 。 通 过 Car， 可 以 很 轻松 地 找到 
它 对 应 的 Engine, 但 反 过 来 则 不 容易 通过 Engine 去 找 它 对 应 的 Car。 此 时 的 数据 库 表 结构 
中 ， 表 Car 包含 表 Engine 的 id 值 作 为 外 键 ， 但 表 Engine 中 不 包含 表 Car 的 id。 

如 果 同 时 还 存在 通过 Engine 去 找 Car 这 样 的 需求 ， 则 不 妨 建立 双向 的 引用 : 


此 时 生成 的 Car 表 和 Engine 表 都 包含 对 方 的 id 作为 外 键 ， 可 以 方便 地 实现 通过 Car 
取出 Engine 和 通过 Engine 取出 Car。 但 此 时 的 Car 和 Engine 彼此 不 存在 级 联 的 更 新 与 删 
除 。 如 果 希 望 实现 级 联 更 新 与 级 联 删 除 ， 需 要 按 如 下 的 方式 去 定义 : 


此 时 数据 库 的 表 结 构 不 会 发 生变 化 ， 但 却 给 Engine 和 Car 定义 了 从 属 关系 ，Engine 
属于 Car。 如 果 Car 被 删除 了 ， 则 Engine 也 会 被 级 联 删除 〈 不 禁 想 起 一 句 话 : 皮 之 不 存 ， 
毛 将 看 附 )。 同 理 ， 如 果 Car 被 更 新 ， 则 相应 的 Engine 也 会 被 更 新 。 

对 于 存在 从 属 关系 的 两 个 对 象 , 保存 也 更 加 容易 。 属 主 的 一 方 (Car) 可 以 保存 另 一 方 : 


11.2.2 一 对 多 关系 


一 对 多 关系 是 关系 数据 库 中 最 常见 的 关系 。 在 数据 库 中 ， 通 过 主键 和 外 键 进行 映射 ; 
在 GORM 中 ， 通 过 hasMany 进行 定义 。 前 面 例子 中 的 Cart 和 LineItem 就 是 典型 的 一 对 多 
关系 : 


上 面 的 例子 中 ，Cart 与 LineItem 是 一 对 多 的 关系 ， 同 时 ， 它 们 之 间 的 引用 方式 是 双向 
的 ， 并 且 可 以 通过 Cart 对 LineItem 进行 级 联 更 新 和 级 联 删除 。 


考虑 到 数据 库 中 表 的 真实 情况 ， 如 果 Cart 与 LineItem 是 一 对 多 的 关系 ， 则 Cart 表 中 
实际 上 不 包含 LineItem 表 中 的 内 容 ， 而 LineItem 表 中 要 包含 Cart 表 的 主键 作为 外 键 引用 。 
但 是 ， 如 果 LineItem 表 中 对 应 多 个 Cart 的 属性 (当然 ， 这 个 在 逻辑 上 不 通 )， 则 可 能 产生 
二 义 性 的 问题 。 

Grails 官方 网 站 中 给 出 了 一 个 例子 可 以 很 好 地 说 明 问 题 :每 个 飞机 场 有 多 架 出 港 飞机 
和 入 港 飞 机 ， 每 架 飞机 有 一 个 起 飞机 场 和 一 个 降落 机 场 ， 如 图 11-1 所 示 。 用 Domain 类 描 


述 飞 机 还 是 比较 简单 的 : 


了 
Ry 


2 


N:1 IN 


机 场 
图 11-1 机 场 与 飞机 


但 是 描述 Airport 有 多 个 出 港 航班 和 多 个 入 港 航班 , 则 有 些 困难 。 因 为 仅 通过 hasMany 
是 无 法 说 明 Airport 的 多 个 航班 中 哪些 是 出 港 的 、 哪 些 是 入 港 的 。 

这 个 问题 比较 复杂 ， 但 也 比较 普遍 。Grails 提供 了 mappedBy 去 解决 类 似 的 问题 。 通 
过 mappedBy 可 以 明确 属性 名 与 字段 的 对 应 关系 。 例 如 ，Airport 的 定义 方法 如 下 : 


相应 地 ， 数 据 库 中 的 表 结 构 还 是 比较 简单 的 : 


11.2.3 ”多 对 多 关系 


多 对 多 关系 在 关系 数据 库 中 , 属于 实体 间 最 复杂 的 情况 , 实现 时 需要 使 用 一 张 关系 表 ， 
通过 两 个 一 对 多 的 关系 ， 最 终 构成 多 对 多 关系 ， 如 图 11-2 所 示 。 


图 11-2 关系 数据 库 中 的 多 对 多 关系 


在 GORM 中 ,同样 可 以 使 用 类 似 的 方式 ， 分别 创 建 对 应 上 面 3 张 表 的 Domain 类 ,分 
别 与 Domain 类 建立 双向 的 一 对 多 关系 。 这 种 做 法 虽然 简单 易 理解 ， 但 并 不 优雅 。 使 用 
GORM 强调 的 是 OO 建 模 ， 关 联 表 对 应 的 对 象 在 逻辑 上 没有 明确 的 含义 ， 而 且 使 用 起 来 也 
不 够 方便 。 

GORM 为 多 对 多 关系 提供 了 非常 良好 的 支持 ， 可 以 直接 在 两 个 对 象 上 同时 使 用 
hasMany。 但 是 有 一 点 不 同 的 是 , 在 多 对 多 的 情况 下 ,必需 在 两 者 之 间 通 过 belongsTo 定义 
从 属 关系 。 


GORM 会 自动 创建 相应 的 关联 表 。 如 果 和 希望 自己 指定 关联 表 ， 可 以 在 mapping 闭 包 中 
指定 ， 例 如 : 


对 于 多 对 多 关系 的 Domain 对 象 ， 其 保存 方式 也 比较 特殊 ， 需 要 用 addTo* 方 法 (这 也 
是 个 名 称 名 可 变 的 方法 )， 例 如 : 


因为 Student 是 Course 的 属 主 ， 所 以 可 以 只 调用 Student 的 save 而 无 需 调 用 Course 的 
save。 反 过 来 则 不 成 立 ，Student 不 会 被 保存 到 数据 库 中 。 


当然 ， 如 果 Course 和 Student 都 已 经 存在 于 数据 库 中 〈 已 经 保存 过 或 者 是 从 数据 库 中 
读 取出 )， 上 面 两 种 写法 都 可 以 正确 工作 ， 例 如 : 


或 


与 addTo* 方 法 使 用 相似 但 是 功能 相反 的 有 removeFrom* 方 法 , 用 于 解除 对 象 间 的 关系 


(删除 关联 表 中 的 数据 ): 


11.2.4 ”继承 关系 


继承 是 OO 技术 中 常见 的 一 种 形式 ， 但 在 关系 数据 库 中 ， 并 不 存在 继承 的 概念 。 幸 运 
的 是 ，GORM 提供 了 一 种 机 制 ， 可 以 弥合 这 两 种 不 同 的 技术 体系 的 差别 :。 

对 于 继承 ，GORM 支持 两 种 继承 策略 : 默认 为 多 个 子 类 共用 同一 张 表 ， 此 时 ， 数 据 库 
相关 的 类 共同 使 用 一 张 “ 最 大 的 ” 表 ， 它 包含 每 一 个 子 类 的 每 一 个 属性 ， 另 一 种 策略 是 所 
有 的 子 类 分 别 使 用 单独 的 一 张 表 ， 每 张 表 和 每 个 子 类 是 一 一 对 应 的 关系 。 下 面 的 代码 是 第 
一 种 继承 策略 的 示例 : 


默认 情况 下 ， 该 代码 生成 数据 库 表 的 DDL: 


其 中 的 class 字段 用 于 识别 每 条 记录 所 对 应 的 Domain 类 型 。 执行 下 面 的 代码 保存 两 条 
记录 到 数据 库 中 : 


则 数据 库 中 数据 记录 变 为 如 表 11-3 所 示 。 


1 准确 地 说 ， 是 Hibemate 提供 的 机 制 。 


表 11-3 ”people 表 中 的 数据 


王 


0 20 John 了 People null 
3 0 20 Tom Student S201 


这 种 “ 基 类 和 子 类 共用 一 张 数 据 库 表 ”的 实现 策略 叫做 table-per-hierarchy， 它 要 求 子 
类 的 属性 在 数据 库 中 的 字段 可 以 为 空 (oullable)。 

另 一 种 “ 基 类 和 子 类 分 别 使 用 不 同 的 数据 库 表 ”的 实现 策略 叫做 table-per-subclass。 需 
要 在 基 类 使 用 mapping 闭 包 进行 定义 : 


此 时 ， 数 据 库 表 的 DDL 为 : 


可 以 看 到 ，GORM 创建 了 两 张 数据 库 表 。 子 类 Student 所 对 应 的 表 的 主键 不 是 增 类 型 
的 。 再 次 执行 前 面 的 数据 保存 ， 则 表 中 数据 如 表 11-4、 表 11-5 所 示 。 


表 11-4 people 表 中 的 数据 


[= 


20 John 
20 Tom 


iD 
So 


表 11-5 student 表 中 的 数据 


2 S201 


显然 Table-per-hierarchy 的 方式 可 以 消除 元 余 字 段 ， 数据 库存 储 效 率 更 高 一 些 。 然而， 
每 次 对 子 类 对 象 的 查询 ， 都 需要 对 两 张 数 据 库 表 进行 联合 查询 ， 性 能 会 有 一 定 的 下 降 。 因 


此 ， 在 使 用 table-persubclass 时 ， 需 要 先 分 析 业 务 的 性 能 需求 并 做 到 避免 设计 继承 深度 过 
深 的 Domain 类 。 


使 用 OO 理念 设计 的 Domain 类 ， 可 以 进行 多 态 查询 ， 使 用 起 来 十 分 方便 ， 例 如 : 


11.2.5 ”合成 关系 


利用 合成 关系 ， 可 以 将 一 个 类 “嵌入 ”到 另 一 个 类 中 去 ， 从 而 减少 不 必要 的 表 联接 ， 
例如 : 


生成 的 Rectangle 表 的 DDL 为 : 


如 果 不 希望 Point 类 也 被 单独 地 生成 一 张 数据 库 表 , 则 不 要 将 Point 类 的 内 容 写 到 一 个 
单独 的 Groovy 文件 中 ， 而 应 该 直接 将 其 写 在 Rectangle 类 所 在 的 Groovy 文件 中 。 


11.3 数据库 查询 小 结 


11.3.1 GORM 提供 了 便捷 的 查询 方法 


GORM 提供 了 许多 简单 易 用 且 功能 强大 的 方法 用 于 对 数据 库 进行 查询 操作 , 前 面 的 章 


节 里 已 经 进行 了 介绍 , 这 里 仅 做 简单 的 小 结 。 GORM 提供 的 查询 方法 可 以 划分 为 8 个 系列 ， 
同一 系列 的 方法 具有 相似 的 逻辑 ， 如 表 11-6 所 示 。 


表 116 GORM 查询 方法 总 结 


list listOrderBy* 


get 


findBy* 
findAllBy* 


count 
countBy* 


findWhere 
findAllWhere 


createCriteria 
withCriteria 


对 整 表 进行 查询 ， 无 法 指定 查询 条 件 ， 但 是 可 以 使 用 分 页 Map 进行 分 页 和 排序 。 
例 : 
Goods.list0// 返 回 全 部 Goods 的 列表 
Goods.list([max:10.offset:10,sort: ‘title', order: 'asc]) // 使 用 分 页 Map 
// 进 行 分 页 和 排序 


Goods.listOrderByTitle([max:10.offset:10,0rder: "desc]) 

根据 Domain 的 id 数据库 主 键 ， 若 为 复合 主键 ， 使 用 其 自身 实例 ) 查询 。 
例 : 

get 方 法 是 使 用 一 个 i4， 返 回 一 条 记录 ， 如 : 

def cart = cart.get(1) // 返 回 id 为 1 的 cart 


getAll 方 法 是 使 用 多 个 id (id 的 List) ， 返 回 多 条 记录 ， 
如 : 
def cartList = Cart.getAll([1.2,3.4]) /返回 id 为 1、2、3、4 的 4 条 Cart 记录 
功能 强大 的 查询 方法 ， 以 属性 值 作为 约束 条 件 ， 也 可 以 使 用 分 页 Map 进行 分 页 
和 排序 ， 详 见 第 6 章 。 
例 : 
def goods = Goods.findByTitle('Grails) /返回 title 为 Grails 的 一 条 记录 
def goodsList = Goods findAllByTitle('Grailsy/ 返回 title 为 Grails 的 
// 所 有 记录 

查询 数据 库 表 中 的 记录 条 数 ， 相 当 于 使 用 SQL: select count(*) fom'… 
例 : 
Goods.count0// 返 回 Goods 的 记录 总 数 ， 相 当 于 select count(*) from goods 
Goods.countByTitle('Grails)/ 返 回 title 为 Grails 的 记录 总 数 ， 相 当 于 

//select count(*) from goods where title = 'Grails’ 
通过 Map 对 数据 库 进行 查询 ， 多 个 条 件 之 间 只 能 是 “与 ”的 关系 ， 而 且 不 支持 
分 页 和 排序 。 
例 : 
// 返 回 一 条 title 为 Grails 并 且 price 为 20.0 的 Goods 记录 
Goods findWhere([title: 'Grails'. price: 20.0] ) 


// 返 回 所 有 title 为 Grails 并 且 price 为 20.0 的 Goods 记录 

def goodsList = Goods.findAllWhere([title: 'Grails' price: 20.0] ) 
使 用 HibemateCriteriaBuilder 对 数据 库 进 行 查询 ， 详 见 第 5 章 。 
例 : 

def ¢ = Goods.createCriteria() 

def goodsList = c.list({ .….}) //{..….} 的 内 容 为 查询 闭 包 


def goodsList = Goods.withCriteria( { .… } ) //{..….} 的 内 容 为 查询 闭 包 


续 表 


find 使 用 HQL 进行 数据 库 查 询 ， 但 HQL 的 查询 内 容 仅 限于 当前 Domain 类 。findAll 
findAll 方法 可 以 使 用 分 页 Map 进行 分 页 。 
例 : 


/返回 HQL 执行 结果 的 一 条 记录 。 
def goods = Goods.find(from Goods where ...') 


/返回 HQL 的 全 部 执行 结果 。 

def goodsList = Goods.findAll(from Goods where ...') 
executeQuery 使 用 HQL 操作 数据 库 , 对 HQL 的 查询 内 容 不 加 限制 。executeQuery 用 于 执行 查 
executeUpdate 询 ，executeUpdate 用 于 执行 更 新 。 

如 果 使 用 了 Hibernate 的 二 级 缓存 ， 则 应 避免 使 用 HQL 更 新 数据 库 


说 明 ， 

(1) 带 * 的 方法 属于 动态 方法 ， 方 法 名 可 以 变化 。 

(2) 对 于 返回 多 条 记录 的 查询 ， 通 常会 返回 List 实例 。 

(3) 分 页 Map 中 可 包含 max、offset、sort、order 共 4 个 键 。 其 中 max 和 offset 用 于 控 
制 分 页 ，sort 和 order 用 于 控制 排序 。max 用 于 设置 最 大 返回 查询 的 结果 ，offset 设置 查询 
的 起 始 记录 ，sort 用 于 指定 排序 的 属性 (字段 )，order 用 于 指定 排序 的 方式 (升序 或 降序 )。 


11.3.2 ”基于 HQL 的 查询 


关于 GORM 的 查询 ， 前 面 的 章节 里 已 经 介绍 了 很 多 ， 这 里 无 需 重复 介绍 ， 除 了 list 方 
法 、get 方法 、findBy 方法 、HibernateCriteriaBuilder 外 ， 还 有 一 种 源 于 Hibemate 的 重量 级 
的 查询 方法 ， 那 就 是 HQL 。 

HQL 是 面向 对 象 的 查询 语言 ， 语 法 与 SQL 相似 ， 功 能 非常 强大 。 但 是 相对 于 前 面 介 
绍 过 的 查询 方法 ， 使 用 HQL 是 相对 比较 复杂 的 ， 一 般 应 用 于 解决 包含 统计 分 析 等 复杂 问 
题 的 场合 。 

下 面 举例 说 明 ， 对 于 最 简单 的 情况 ， 查 询 取出 所 有 的 商品 列表 ， 可 以 用 如 下 HQL 进 
行 查询 : 


如 果 希 望 查询 category 为 “book” 的 商品 ， 则 HQL 为 : 


对 于 前 面 章 节 中 计算 购物 车 内 商品 总 价 的 程序 ， 完 全 可 以 用 HQL 在 数据 库 内 部 进行 


z 
流 


上 面 的 HQL 用 到 了 查询 参数 , HQL 支持 有 名 和 匿名 两 种 参数 形式 。 如 果 是 匿名 查询 ， 


应 使 用 一 个 数组 传递 参数 ， 数 组 内 元 素 要 与 “?” 按 顺序 一 一 对 应 ; 如 果 使 用 有 名 参数 ， 则 
应 使 用 Map 去 传递 参数 ，Map 的 key 要 与 参数 名 一 一 对 应 (不 用 考虑 顺序 )。 上 例如 果 使 
用 有 名 参数 查询 ，HQL 的 写法 如 下 : 


HQL 所 包含 的 内 容 异 常 丰富 , 但 它 并 不 是 本 书 的 重点 , 这 里 不 对 其 进行 进一步 的 介绍 ， 
感 兴趣 的 读者 可 以 参考 Hibernate 官方 网 站 中 HQL 的 教程 器 。 

在 Grails 中 执行 HQL 有 两 类 方法 : 一 类 是 find、findAll 方法 ; 另 一 类 是 executeQuery、 
executeUpdate 方法 。 对 于 find 和 findAll 方法 ， 要 求 HQL 只 能 对 当前 的 Domain 类 所 对 应 
的 表 进 行 查询 ， 而 executeQuery、executeUpdate 方法 则 不 对 查询 目标 做 任何 要 求 。 因 此 ， 
Cart 的 totalPrice 方法 可 以 改写 为 如 下 形式 (匿名 参数 或 有 名 参数 两 种 写法 ): 


注意 ，HQL 不 支持 Groovy 的 多 行 字符 串 “"""”， 但 可 以 使 用 “\” 进 行 换行 。 
使 用 HQL 同样 支持 分 页 Map( 只 分 页 不 排序 ), 方法 和 findBy 方法 完全 一 致 ， 只 需要 
再 传 入 一 个 描述 分 页 逻辑 的 Map，Map 中 包含 max 和 offset (参考 fndBy* 的 用 法 ): 


11.4 对 GORM 进行 性 能 优化 


前 面 的 章节 曾经 介绍 过 ，GORM 默认 使 用 延 时 加 载 。 但 使 用 延 时 加 载 就 可 能 带 来 n+1 
次 查询 的 问题 ， 从 而 带 来 严重 的 性 能 问题 。 针 对 n+l 次 查询 的 问题 ， 有 两 种 解决 方案 : 一 


类 是 取消 延 时 加 载 或 设置 抓 取 模式 为 “eager”， 从 而 实现 一 次 查询 取出 全 部 对 象 ， 另 一 类 
是 使 用 二 级 缓存 ， 从 而 减少 对 数据 库 的 访问 。 


11.4.1 设置 抓 取 模 式 
对 于 存在 关联 的 对 象 ， 可 以 根据 具体 使 用 情况 ， 设 置 为 非 延 时 加 载 。 对 于 前 面 讨论 过 


的 LineItem 和 Goods， 就 应 该 使 用 非 延 时 加 载 。 显 然 ， 访 问 LineItem 的 时 候 ， 都 要 访问 
Goods。 使 用 CriteriaBuilder 进行 查询 ， 可 以 指定 抓 取 策略 。 


此 时 生成 的 SQL 是 对 两 张 表 进行 连接 后 的 查询 : 


11.4.2 ”使 用 二 级 缓存 


Grails 自 1.0 版 开始 ， 对 Hiberate 的 二 级 缓存 提供 了 支持 。Hibernate 的 二 级 缓存 分 别 
是 针对 实体 对 象 和 SQL 进行 的 (Query-Cache)。 二 级 缓存 相当 于 Map， 分 为 对 象 Map 和 


Query Map 两 类 .对 象 Map 是 以 Domain 类 的 id 作为 key, 将 对 象 内 容 进 行 缓存 ;Query Map 
是 以 SQL 语句 作为 key， 但 只 缓存 查询 结果 的 id。 
首先 要 在 DataSource.groovy 中 开启 二 级 缓存 : 


从 1.03 版 开始 ，Grails 默认 使 用 OSCache 作为 默认 的 缓存 组 件 。 感 兴趣 的 读者 可 以 访 
问 http://www.opensymphony.com/oscache/ 了解 更 多 有 关 OSCache 的 信息 。 如 果 想 要 对 
OSCache 进行 详细 的 配置 ， 可 以 编写 OSCache 的 配置 文件 (oscache.properties)， 并 把 它 放 
到 grails-app\conf 中 。 通过 这 个 配置 文件 , 可 以 设置 OSCache 组 件 的 内 存 使 用 、 硬盘 使 用 、 


调度 算法 等 。 
可 选用 的 缓存 组 件 如 表 11-7 所 示 。 
表 11-7 Cache 组 件 来自 Hibernate 官方 网 站 ) ” 

EHCache org.hibernate.cache 。 Imemory. disk 否 是 
.EhCacheProvider 

OSCache org.hibernate.cache memory, disk 否 是 
.OSCacheProvider 

SwarmCache org.hibernate.cache clustered 是 否 
.SwarmCacheProvider (ip 广播) 

JBoss org.hibernate.cache clustered 是 是 

TreeCache .TreeCacheProvider (ip 广播 )，transactional (需要 时 钟 同步 ) 


如 果 要 将 应 用 部 署 到 集群 环境 中 ， 则 需要 选用 一 个 支持 集群 的 Cache 组 件 。 

首先 ， 配置 对 象 缓存 ， 这 样 就 可 以 为 不 同 的 Domain 对 象 配置 具体 的 缓存 使 用 策略 了 。 
对 Domain 对 象 使 用 缓存 有 一 个 重要 的 前 提 条 件 ， 就 是 它 的 读 取 访 问 次 数 要 远大 于 更 新 次 
数 ， 否 则 使 用 缓存 是 没有 意义 的 。 对 Goods 类 使 用 缓存 ， 如 下 所 示 : 


1 事实 上 , 最 新 版 的 EHCache 和 OSCache 都 已 经 支持 使 用 集群 环境 了 , 读者 可 以 访问 相关 网 站 了 解 。 


此 时 ,使 用 的 策略 是 “read-write”， 并 且 对 所 有 属性 进行 缓存 。 如 果 想 进行 详细 配置 ， 
则 可 以 写成 : 


usage 决定 了 使 用 缓存 的 策略 ， 其 中 可 选用 的 Cache Usage 如 表 11-8 所 示 。 


表 11-8 Cache Usage 


read-only 针对 只 读 型 的 数据 ， 要 求 Domain 对 象 不 能 被 更 新 insert 和 delete 是 可 以 的 ) 。 拥 有 
最 佳 的 缓存 性 能 

Tead-write 允许 被 缓存 的 对 象 进行 更 新 操作 。 实 际 测试 中 表现 效果 一 般 

nonstrict-read ”允许 被 缓存 的 对 象 进 行 更 新 操作 。 性 能 较 “read-write” 有 显著 的 提高 ， 推 荐 使 用 。 但 

-write 由 于 使 用 了 非 严格 读 写 的 策略 ， 不 适合 使 用 在 存在 多 个 事务 并 发 访问 的 敏感 的 数据 上 
(如 金融 、 财 务 等 ) 

transactional 。 要 求 缓存 组 件 中 的 数据 也 拥有 事务 隔离 能 力 〈 如 JBoss TreeCache) ， 并 且 程序 必须 运 
行 在 完整 的 JTA 环境 中 。 如 果 使 用 了 这 一 策略 ， 还 需要 对 Hibemate 进行 额外 设置 : 需 
要 在 DataSource.groovy 中 的 Hibernate 闭 包 中 指定 transaction.manager lookup class。 
参考 Hibernate 官方 网 站 中 关于 Cache 配置 的 部 分 : 
http://www.hibernate.org/hib_docs/reference/en/html/performance.html#performance-cache 


默认 情况 下 ，Cache 将 Domain 对 象 的 所 有 属性 都 记 入 Cache( 即 include: 'all'); 也 可 
以 仅 缓存 Domain 中 非 延 时 加 载 的 属性 (include: "non-lazy')。 
除了 在 Domain 上 配置 缓存 ， 还 可 以 为 它 的 集合 属性 配置 缓存 : 


在 Congfig.groovy 中 开启 Hibernate 对 Cache 的 日 志 输 出 , 以 观察 Cache 的 使 用 情况 ( 建 
议 使 用 grails console， 并 重复 执行 Domain.get0 方 法 ): 


- 和 


观察 日 志 的 输出 内 容 ， 可 以 看 到 使 用 了 不 同 缓存 策略 的 对 象 在 查询 时 的 缓存 命中 
情况 


从 输出 的 日 志 中 会 发 现 一 个 现象 ，Query-Cache 从 来 都 没 生 效 过 。 并 不 是 配置 有 问题 ， 
而 是 因为 在 Hibemate 中 要 使 用 Query-Cache， 需 要 设置 Query 或 Criteria 的 cacheable 属性 
为 tue。 所 以 ， 执 行 下 面 的 查询 代码 ， 就 可 以 在 日 志 中 看 到 Query-Cache 也 被 命中 了 : 


查看 日 志 中 Cache 相关 的 信息 : 


由 于 Query-Cache 只 是 缓存 查询 结果 的 id (主键 )， 当 Query-Cache 命中 时 ， 从 缓存 中 
取出 的 也 只 是 这 一 组 id， 如 果 id 对 应 的 对 象 不 在 二 级 缓存 中 ， 还 需要 从 数据 库 中 读 取 。 
此 , 千 万 不 要 在 查询 没有 配置 缓存 的 Domain 时 使 用 Query-Cache， 这 样 将 带 来 严重 的 性 能 
问题 。 

目前 唯一 能 够 使 用 Query-Cache 的 办 法 ， 就 是 使 用 HibemateCriteriaBuilder 进行 查询 ， 
并 且 指 定 cacheable 为 true。 这 是 因为 使 用 GORM 提供 的 list、getAll、find* 等 方法 ，Query- 
Cache 都 不 会 起 作用 。Grails 的 开发 组 织 在 封装 上 述 方法 时 ,分 别 使 用 了 Spring 的 Hibemate- 
Template 和 Hibemate 的 Criteria。 但 无 论 使 用 了 哪 种 方式 , 都 没有 设置 相关 对 象 的 cacheable 
属性 为 tue， 因 而 根本 没有 使 用 Query-Cache。 

这 不 能 不 说 是 现在 版 本 Grails (Grails 1.0 一 Grails 1.0.4) 的 一 个 bug， 而 且 用 户 可 以 在 


官方 提供 的 用 于 跟踪 bug 的 数据 库 中 找到 这 个 bugl9。 本 书 的 最 后 部 分 将 尝试 修改 Grails 
的 代码 去 解决 这 个 bug， 这 就 是 源 代码 开放 的 好 处 。? 

缓存 的 使 用 并 不 是 越 多 越 好 ， 需 要 具体 问题 具体 分 析 。 通 过 压力 测试 和 日 志 分 析 ， 对 
系统 进行 反复 的 调整 ， 才 能 最 终 将 系统 的 性 能 调 至 最 优 。 


11.5 ”使 用 GRAG 工具 生成 Domain 


GRAG (GRails Application Generator) 并 不 是 Grails 框架 的 一 部 分 ， 它 是 一 个 用 于 生成 
Grails Domain 类 的 工具 。 它 可 以 读 取 数据 库 中 的 表 结 构 ， 并 根据 表 结构 生成 Domain 类 。 
有 了 GRAG 工具 的 帮助 ， 兼容 旧 数 据 库 不 再 是 一 件 麻 烦 的 事情 了 。 熟 悉 Hibernate Tools 的 
读者 应 该 对 这 种 工具 比较 熟悉 了 。 

首先 下 载 GRAG: http://sourceforge.net/project/showfiles.php?group_id=230641。 下 载 完 
成 后 解压 即 可 使 用 。Windows 平台 下 假设 解压 到 d:\grag1.0) 运行 di\grag1.0\bin\gui.bat， 
Linux/UNIX 平台 下 假设 解压 到 ~/grag1.0) 运行 ~/grag1.0/bin/gui.sh， 会 看 到 如 图 11-3 所 
示 的 窗口 。 


图 11-3 GRAG 启动 界面 | 
接 下 来 保存 工程 (注意 ， 这 里 的 工程 和 Grails 工程 没有 直接 关系 )， 执 行 FilelSave 命 


1 事实 上 ,现在 最 新 的 Beta 版 一 一 1.1 Beta2， 已 经 为 分 页 Map 中 添加 了 cache key， 用 于 人 允许 用 户 在 
查询 时 开启 Query-Cache。 


11-4 保存 GRAG 工程 文件 


接 下 来 配置 数据 库 的 连接 ， 单 击 左 侧 工 程 中 的 Datasource， 然 后 输入 数据 库 的 类 型 、 
连接 url、 用 户 名 和 密码 :， 如 图 11-5 所 示 。 


‘ha 
jdbe:mysql://localhost:3306/gdepot_dey| v 


root 


11-5 配置 数据 库 连 接 


然后 执行 Database|Create connection 命令 ， 在 弹出 的 对 话 框 中 修改 连接 参数 ， 单 击 
Connect 按钮 ， 如 图 11-6 所 示 。 


tahles lvies 


图 11-6 ”连接 数据 库 


”GRAG 默认 提供 了 PostereSQL、MySQL、Hypersonic SQL 共 3 种 数据 库 的 JDBC 驱动 ， 如 果 使 用 
了 其 他 数据 库 ， 还 需要 先 单 击 Database Driver Manager 按钮 配置 其 他 数据 库 的 JDBC 驱动 。 


连接 成 功 后， 执行 EditlAddlentity 命令 (或 按 Cul+1 键 )， 或 者 单 击 工具 栏 的 鳞 按 钮 。 

在 弹出 的 对 话 框 中 选择 需要 映射 的 数据 库 表 (不 要 选择 多 对 多 的 关系 表 ， 因 为 它 是 不 
需要 映射 的 )， 然 后 单 击 Select 按钮 ， 如 图 11-7 所 示 。 可 以 发 现 GRAG 会 将 被 选中 的 表 配 
置 为 Entity Class， 并 显示 在 左 侧 的 工程 中 ， 如 图 11-8 所 示 。 


EE 


Conposite key 


Description: 


11-7 选择 数据 库 表 图 11-8 成 功 导入 为 实体 类 


当然 ， 自 动 映射 的 类 不 可 能 完全 满足 需求 ， 所 以 GRAG 还 提供 了 简单 的 修改 功能 。 在 
左 侧 选 择 不 同 的 实体 类 ， 然 后 就 可 以 在 右 侧 进 行 修改 。 修 改 完毕 ， 执 行 FilelGenerate 
Application 命令 ,或 者 单 击 工具 栏 的 按钮 ， 会 将 实体 类 导出 成 Groovy 类 文件 。 

生成 的 Groovy 代码 如 下 ， 以 Goods.groovy 为 例 : 


从 上 面 的 代码 可 以 看 出 ，GRAG 的 功能 很 强大 ， 它 生成 的 Domain 类 中 包括 mapping、 
属性 、 表 间 关 系 和 constraints。GRAG 确实 能 够 减轻 为 兼容 历史 数据 库 时 而 手动 编写 映射 
代码 的 任务 。 但 毕竟 机 器 是 无 法 取代 人 的 ， 它 自动 生成 的 代码 也 并 不 完美 : GRAG 没有 利 
用 默认 的 属性 名 与 字段 名 的 对 应 关系 ， 而 完全 用 mapping 呈 进行 配置 。 因 此 ， 它 生成 的 
Domain 类 会 比较 庞大 。 通 常情 况 下 ， 还 需要 对 其 生成 的 代码 进行 修改 。 毕 竟 GRAG 现在 
还 只 是 1.0 版 本 ， 有 理由 相信 它 会 不 断 进 步 的 。 


11.6 ”本章 小 结 


本 章 对 GORM 的 高 级 特性 进行 了 比较 完整 的 介绍 。 涉 及 到 自 定义 映射 、 复 杂 的 对 象 
关联 、 数 据 库 的 查询 、 性 能 调 优等 。 本 章 的 最 后 一 节 介绍 了 GRAG 工具 ,通过 它 可 以 帮助 
实现 从 数据 库 表 结构 生成 Domain 类 。 熟 练 掌握 本 章 的 内 容 ， 是 灵活 驾驭 Grails 的 基础 。 


| py 5 Spring 


通过 在 GORM 中 使 用 自 定义 映射 ， 可 以 解决 兼容 遗留 数据 库 的 问题 。 如 果 遗 留 的 产 
品 中 有 封装 的 比较 优秀 的 Java 组 件 ,也 可 以 直接 在 Grails 中 使 用 ,毕竟 Groovy 可 以 对 Java 
程序 进行 透明 调 

此 外 ,由 于 Grails 是 基于 Spring 的 设计 , 使 得 很 多 外 部 的 组 件 可 以 通过 Spring 引入 系 
统 。 这 样 就 可 以 使 用 DI (DI，Dependence Injection， 依 赖 注入 ) 模式 ， 设 计 出 更 加 松 耦 合 
的 系统 。 

本 章 将 先 对 Spring 进行 简单 的 介绍 ， 然 后 讨论 Grails 如 何 封 装 Spring， 并 将 重点 介绍 
Grails 提供 的 用 于 简化 Spring 配置 文件 编写 的 DSL。 本 章 的 内 容 对 于 掌握 Grails 的 Web 开 
发 ， 用 处 并 不 大 ， 但 如 果 希 望 学 习 Grails 的 原理 ， 则 有 必要 了 解 一 二 ， 不 然 在 阅读 Grails 
的 源 代码 时 可 能 会 比较 困惑 。 


12.1 依赖 注入 与 Spring 容器 基础 


12.1.1 依赖 注入 


一 个 设计 优秀 的 系统 应 该 遵循 着 “ 开 闭 原则 ”。 所 谓 “ 开 闭 原 则 ” 指 的 是 一 个 软件 实 
体 应 当 对 扩展 开放 ， 对 修改 关闭 。 也 就 是 说 ， 在 加 入 新 的 功能 时 ， 应 该 避免 修改 现 有 部 分 。 
面向 对 象 的 设计 方法 中 ,会 使 用 多 态 机 制 去 实现 开放 。 在 Java 世界 中 ， 进 行 系统 设计 时 通 
常会 先 将 业务 逻辑 抽象 成 一 系列 接口 。 显 然 ， 面 向 接口 编程 ， 系 统 的 可 扩展 性 更 好 ， 结 构 
也 更 加 清晰 。 

假设 有 接口 Service， 和 它 的 实现 类 ServiceImp， 其 程序 代码 如 下 : 


public interface Service { 
public void doSomething() 
} 


public class ServiceImp implement Service { 
public void doSomething() { 
// 实 现 dosomething 的 业务 
} 


如 果 在 Client 类 中 调用 Service， 则 Client 的 程序 如 下 : 


此 时 , Client 类 与 Service 接口 的 关系 是 关联 关系 , 而 与 ServiceImp 的 关系 是 依赖 关系 。 
用 UML 表示 如 图 12-1 所 示 。 


图 12-1 Client 与 ServiceImp 存在 依赖 关系 


其 中 Client 与 ServiceImp 的 依赖 关系 这 里 并 不 喜欢 。 依 赖 关系 的 存在 ， 就 意味 着 在 
ServiceImp 类 不 存在 的 时 候 ，Client 类 就 无 法 编译 通过 ; 也 意味 着 一 旦 想 换 用 其 他 类 实现 
Service 接口 ，Client 类 也 需要 进行 修改 。 因 此 ， 不 消除 这 个 依赖 关系 ， 就 没有 真正 地 实现 
“ 开 闭 原则 ”。 

使 用 依赖 注入 模式 , 也 可 称 为 控制 反 转 ( 即 IoC), 可 以 帮助 实现 消除 上 述 的 依赖 关系 。 
实现 依赖 注入 ， 实 际 上 就 是 使 Client 类 拥有 一 个 可 写 的 service 属性 。 在 调用 Client 之 前 ， 
再 将 Service 子 类 的 实例 传 入 〈 注 入 ) 到 Client 中 。 


显然 ， 此 时 的 Client 类 与 ServiceImp 类 不 存在 依赖 关系 。 无 论 Service 的 实现 类 如 
何 变化 ，Client 类 都 不 需要 修改 ， 也 不 需要 重新 编译 。 此 时 的 UML 类 图 表示 如 图 12-2 
所 示 。 


图 12-2 ”Client 与 ServiceImp 不 存在 依赖 关系 


凡事 有 利 必 有 弊 ， 虽 然 消 除了 依赖 关系 ， 但 是 Client 的 调用 则 变 得 更 麻烦 了 : 需要 先 
使 用 new 创建 Client 的 实例 ， 然 后 还 需要 将 Service 的 实例 传 入 Client。 如 果 忘 了 传 , 会 有 
恼人 的 “ 空 引用 ”异常 抛 出 。 

可 以 想象 ， 当 系统 达到 一 定 规模 时 ， 大 量 的 接口 与 接口 相互 引用 , UML 类 图 中 会 看 到 
复杂 的 树 状 或 网 状 关联 结构 。 那 么 此 时 的 初始 化 工作 会 变 得 异常 复杂 ， 消 除 依赖 所 带 来 的 
好 处 也 几乎 全 被 抵消 了 。 

Spring 的 诞生 使 得 大 量 使 用 依赖 注入 成 为 了 可 能 ， 因 为 它 能 够 普 程序 员 完成 将 依赖 对 
象 “ 注 入 ”的 任务 ， 从 而 解决 了 初始 化 复杂 的 问题 。 


12.1.2 ”Spring 容器 基础 


Spring 设计 了 一 个 存放 Java 对 象 的 容器 ， 能 通过 XML 或 者 annotation 进行 配置 。 容 
器 内 定义 的 对 象 可 以 自动 或 手动 地 配置 依赖 关系 。 由 于 Spring 本 身 也 是 一 个 非常 庞大 复杂 
的 JEE 框架 ， 本 书 不 会 对 其 进行 全 面 和 深入 的 介绍 ， 仅 介绍 一 些 必要 的 基础 知识 〈 基 于 
XML 的 容器 配置 )。 更 多 关于 Spring 的 高 级 特性 ， 读 者 可 以 参考 Spring 的 官方 教程 四。 

Spring 的 核心 就 是 它 的 DI 容 器 ,其 XML 配置 文件 内 的 主要 内 容 就 是 配置 容器 内 的 Java 
对 象 。<bean></bean> 用 于 在 Spring 容器 内 定义 对 象 ， 例 如 : 


此 时 ， 如 果 通 过 容器 去 获取 client， 就 可 以 得 到 初始 化 了 service 属性 的 client 实例 ， 
因为 Spring 会 根据 client bean 的 property 的 配置 ， 引 用 容器 中 的 service 对 象 初始 化 client 
的 service 属性 , 即 执行 client.setService(service)。 可 以 通过 Spring 提供 的 BeanFactroy 或 者 
ApplicationContext， 根 据 id 从 容器 中 取出 对 象 ( 不 过 一 般 不 需要 这 样 做 ， 这 里 仅 作为 基本 
了 解 进行 介绍 ): 


<bean/> 元 素 包含 了 大 量 可 以 配置 的 属性 ， 可 以 实现 对 容器 中 的 元 素 进行 详细 的 配置 ， 
详细 情况 如 表 12-1 所 示 。 


表 12-1 Spring 配置 XML 中 bean 元 素 的 常用 属性 


id 定义 对 象 在 容器 中 的 唯一 ”每 个 bean 都 需要 有 唯一 的 id 
名 称 。 用 于 引用 bean 
class bean 对 应 的 类 应 该 是 包含 完整 的 包 名 和 类 名 的 全 称 
scope bean 的 作用 域 singleton ”默认 的 作用 域 ,同一 个 bean 在 容器 中 创建 唯一 
的 实例 
prototype 每 次 访问 都 创建 新 的 实例 
Tequest bean 的 生命 周期 与 HTTP request 相同 。 每 次 


HTTP request 开始 时 ， 创 建新 的 bean。 同 一 个 
HTTP request 的 多 次 访问 ， 使 用 相同 的 实例 
Session bean 的 生命 周期 与 HTTP session 相同 。 同一 个 
session 的 多 次 访问 ， 使 用 相同 的 实例 
global bean 的 生命 周期 与 global HTTP session 相同 


autowire bean 属性 自动 绑 定 策略 。 no 不 使 用 自动 绑 定 
byName 根据 属性 名 和 bean id 实现 自动 绑 定 
byType 根据 属性 类 型 和 bean 类 型 实现 自动 绑 定 
constructor ”根据 构造 函数 进行 初始 化 绑 定 
autodetect 。 自动 检测 。 会 自动 选择 使 用 constructor 方式 ， 
或 者 byType 方 式 


说 明 : 

(1) request、session 和 global session 都 需要 Spring 运行 于 Web 容器 中 ， 并 且 Spring 
能 够 访问 Web 容器 的 资源 (例如 Grails 中 Spring 运行 的 方式 )。 

(2) 使 用 autowire 属性 可 以 减少 XML 代码 的 体积 。 前 面 的 实例 可 以 简化 为 : 


但 是 使 用 autowire 也 有 可 能 带 来 二 义 性 的 错误 , 例如 ， 当 容器 中 有 多 个 实现 了 Service 
接口 的 类 的 bean 时 ， 若 使 用 byType 方式 的 autowire，Spring 就 会 报错 。 

理解 了 Spring 的 autowire 特性 , 就 不 难 理解 为 什么 在 Controller 中 使 用 Service 时 无 需 
对 其 进行 初始 化 就 可 以 直接 调用 : 是 Spring 的 autowire 特性 帮助 完成 了 绑 定 。 不 过 由 于 在 
Controller 中 定义 Service 时 使 用 了 无 类 型 的 “def”，Spring 只 能 通过 byName 的 方式 进行 
绑 定 。 


12.2 在 Grails 中 使 用 Spring 


Grails 是 基于 Spring 的 ， 当 然 也 允许 用 户 在 Spring 容器 中 添加 其 他 的 bean。 用 户 可 以 


在 config\spring 文件 夹 中 添加 Spring 的 配置 文件 ， 如 resourcesxml， 也 可 以 是 resources. 
groovy。 如 果 使 用 XML 方式 添加 bean， 按 上 节 介 绍 的 方法 在 resources.xml 中 添加 
“<bean></bean>” 即 可 。 除 此 以 外 ，Grails 中 还 提供 了 一 种 用 于 配置 Spring 的 DSL。 使 用 
Spring DSL， 配 置 过 程 更 加 简单 ， 也 更 加 灵活 。 

首先 通过 两 段 等 价 XML 和 Spring DSL 进行 对 比 ， 以 理解 Spring DSL 的 含义 。 

使 用 XML: 


使 用 DSL: 


如 果 需 要 修改 bean 的 属性 ， 可 以 按 如 下 方式 : 


显然 ， 使 用 Spring DSL 更 加 简洁 ， 而 且 可 以 实现 动态 配置 Spring。 本 质 上 ，Grails 通 
过 grails.spring.BeanBuilder 实现 Spring DSL。Grails 在 启动 时 ， 对 dataSource、Hibernate 
等 的 配置 和 初始 化 ， 都 是 通过 Spring DSL 完成 的 。 下 面 的 代码 摘录 于 org.codehaus.groovy. 
grails.plugins.orm.hibernate.HibernateGrailsPlugin.groovy: 


无 论 是 使 用 XML 方式 还 是 使 用 Spring DSL 方式 定义 的 Spring 配置 文件 , 所 有 配置 的 
值 都 可 以 使 用 10.2 节 介绍 的 配置 方法 重新 指定 。 其 格式 为 : 


在 这 时 ， 定 义 dataSource.driverClassName=commysqljdbc.Driver， 实 际 上 是 修改 了 
Spring 容器 中 定义 的 dataSource bean 的 driverClassName 属性 的 值 。 


12.3 本章 小 结 


Spring 框架 是 非常 优秀 的 轻 量 级 J2EE 框架 ， 正 是 由 于 它 的 简洁 与 优雅 ，Grails 选择 
Spring 作为 基础 框架 。 本 章 对 DI (IoC) 模式 进行 了 简单 的 介绍 ， 并 以 此 引出 了 Spring 框 
架 的 价值 所 在 。 本 章 对 Spring 的 基础 知识 进行 了 简单 的 介绍 ， 并 且 介绍 了 Grails 提供 的 用 
于 封装 Spring 配置 信息 的 DSL。 相 信 读 者 在 阅读 了 本 章 以 后 ， 能 够 配置 Spring 容器 中 的 
bean， 从 而 实现 更 加 方便 地 调用 遗留 的 Java 组 件 。 
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本 质 上 ，Grails 的 MVC 是 基于 Spring MVC 的 。 相 比 GORM，Controller 中 新 的 知识 
点 并 不 算 多 。 本 章 将 在 对 Controller 的 知识 点 进行 简单 小 结 之 后 , 着重 对 Web 流 技术 (Web 
Flow) 进行 介绍 。 


13.1 ”Controller 中 常用 的 属性 与 方法 


表 13-1、 表 13-2 分 别 总 结 了 Grails Controller 中 常见 的 属性 与 方法 。 
表 13-1 Controller 中 常用 的 属性 


属性 名 作用 

controllerName 取得 当前 controller 的 名 字 

actionName 取得 当前 action 的 名 字 

grailsApplication org.codehaus.groovy.grails.commons.GrailsApplication 接口 的 实例 ， 可 以 通过 
grailsApplication 读 取 Grails 的 配置 信息 config、 元 数据 metadata 以 及 类 加 载 器 
classLoader 

Tequest Servlet API 中 的 javax.servlet.http.HttpServletRequest 接口 的 实例 。 可 参考 Sun 


J2EE 规范 API 文档 
http://java.sun.com/i2ee/1.4/docs/api/javax/servlet/http/HttpServletRequest.html 
response Servlet API 中 的 javax.servlet.http.HttpServletResponse 接口 的 实例 。 可 参考 Sun 
J2EE 规范 API 文档: 
http://java.sun.com/j2ee/1.4/docs/apijavax/servlet/http/HttpServletResponse.html。 
通过 response， 可 以 实现 输出 二 进 制 数据 ， 通 常用 于 输出 图 片 、 下 载 文件 等 
flash flash 相当 于 一 个 Map。 它 被 自动 存放 到 session 中 ， 并 且 自 动 在 下 次 request 执 
行 完成 时 清空 Map 的 内 容 。 使 用 flash， 可 以 实现 在 两 次 HTTP request 中 共享 
数据 ， 可 以 解决 request 对 象 中 的 数据 在 redirect 之 后 会 丢失 的 问题 。 通 常用 于 
向 GSP 页 面 传递 文本 消息 
session Servlet API 中 的 javax.servlet.http.HttpSession 接口 的 实例 .可 用 于 在 会 话 范围 内 
共享 数据 
servletContext Servlet API 中 的 javax.servlet.ServletContext 接口 实例 。 可 参考 Sun J2EE 规范 
API 文档 : 
http://java.sun.com/j2ee/1.4/docs/api/javax/servlet/ServletContext.html。 
可 用 于 在 全 局 范围 内 共享 数据 
params params 相当 于 一 个 Map， 可 以 获取 页 面 表单 数据 。 
页 面 表单 项 的 name 和 value， 提 交 后 成 为 params 的 key 和 value。 
如 果 页 面 有 多 个 表单 项 name 相同 (如 复 选 框 checkbox) ， 则 提交 后 params 可 
以 通过 List 返回 多 个 value 


bindData 


Tender 


表 13-2 Controller 中 常用 的 方法 


将 Map 的 数据 写 入 对 象 (Groovy 或 Java 对 象 均 可 ), 通常 用 于 绑 定 params 至 Domain 。 
用 法 : bindData(target. params. excludes, prefix) 
参数 : 
target 目标 对 象 ， 接 收 数据 ; 
params: 数据 来 源 ， 通 常 为 params 属性 ， 也 可 是 其 他 的 Map; 
excludes: 可 选 参数 ， 用 于 指定 不 希望 被 绑 定 的 属性 ; 
prefix: 可 选 参数 ， 用 于 给 指定 params 的 key 指定 公共 前 级 ， 前 级 与 属性 名 用 “.” 分 
隔 。 使 用 前 缀 可 以 便于 区 分 一 次 表单 提交 包含 的 多 个 对 象 的 属性 。 
示例 : 
bindData(goods.params) 
bindData(goods.params.["title"."price"]) 不 更 新 goods 的 title 和 price 属性 
bindData(goods, params, []."goods") 假定 params 中 的 key 包含 goods 前 缀 ， 例 如 : key 
为 "goodstitle" 
实现 重 定向 ( 跳 转 ) ， 本质 上 是 通过 HttpServletResponse 的 sendRedirect 方法 实现 的 。 
Tedirect 方法 的 参数 是 一 个 Map，Map 中 可 以 使 用 下 列 key 配置 跳 转 : 
controller: 指定 目标 controller; 
action: 指定 目标 action， 如 果 没 有 指定 controller， 则 为 当前 controller; 
id: 用 于 向 目标 action 传递 的 参数 ， 
uri; 指定 完整 的 跳 转 uri， 如 /book/list，/book/get/1; 
url: 完整 的 Web URL， 如 http://www.grails.org; 
params: 使 用 map 传递 参数 ; 
fragment: 指定 URL 中 的 锚 点 (/help.html#index 中 # 后 面 的 部 分 ) ， 在 使 用 fragment 
时 不 要 包含 “#” 
输出 文字 、 页 面 或 者 模板 页 面 。render 方法 的 功能 非常 强大 。 
例 1: 输出 文字 (一般 来 说 ， 用 处 不 大 》。 
Tender "Hello World" 
还 可 以 指定 contentType 和 编码 
Tender ( text: "<xml>Hello World</xml>". 
contentType:"text/xml".encoding:"UTF-8") 
例 2: 输出 GSP (最 重要 且 最 常用 的 用 法 ) 。 
使 用 model map 向 GSP 传递 数据 
Tender(view: "list". model : [goodsList: Goods.listO]) 


若 不 指定 model， 则 自动 将 controller 作为 model 传递 给 GSP view，GSP 中 可 以 直接 
访问 Controller 中 定义 的 属性 。 (与 Webwork 或 Ruby on Rails 的 传递 方式 相似 ) 。 
Tender(view: "list")。 

例 3: 输出 Builder 闭 包 。 

受益 于 Groovy 强大 的 闭 包 和 MOP 机 制 ， 大 量 基于 Goovy 的 DSL 被 开发 出 来 (通常 
用 于 构造 表示 树 形 结构 的 数据 ) 。 


通过 HTML Builder 输出 HIML 
Tender { 
table (id: "news" ) { 
tt{ 
td ("title") 


} 

实际 输出 为 : 

<table id="news"><tr><td>title</td><td>date</td></tr></table> 
如 果 指 定 了 render 的 contentType， 还 可 以 输出 XML 或 JSON 数据 。 


XML 示例 : 
Tender (contentType:"text/xml") { 
for(g in goodslist) { 
goods ( title: g.title, price: g.price) 


} 
实际 输出 为 : 
<goods title='Grails' price="20.00'/><goods title="Groovy' price="20.00'/> 


JSON 示例 : 
Tender (contentType:"text/json") { 
for(g in goodslist) { 
goods ( title: g.title, price: g.price) 
} 


} 
实际 输出 为 : 
{"goods": {"title":"Grails","price":20}."goods": {"title":"Groovy","price":20}} 


例 4: 使 用 convertor 输出 。 
使 用 convertor 可 以 简化 XML 或 JSON 的 输出 : 
import grails.converters.* 


Tender Goods.get(params.id) as XML 
Tender Goods.list(params) as JSON 


例 5: 使 用 template 输出 (在 GSP 中 更 常用 ) 。 

render 方法 的 功能 与 7.2 节 介绍 的 GSP render tag 相同 ， 用 法 也 相似 。 
输出 模板 页 面 。 

如 : render template: 'templateName' 


指定 model， 模 板 页 面 可 以 通过 model 的 key 访问 变量 。 
如 : render template: 'templateName' model:[varl:valuel.var2:value] 


指定 bean 〈 此 时 只 传 入 一 个 对 象 ， 模 板 页 面 使 用 “it” 访 问 bean 的 内 容 ) 。 
如 : render template: ‘templateName'.bean:obj 


续 表 


render 指定 bean， 并 且 使 用 var 指定 页 面 访问 bean 的 变量 名 称 。 
如 : render template: 'templateName'bean:obj. var: 'goods' 
此 时 模板 页 通过 “goods” 访 问 obj。 


指定 collection， 则 遍历 集合 时 ， 每 取出 一 个 集合 元 素 ， 将 其 传 给 模板 ， 并 输出 一 次 
template。 如 果 指 定 了 var， 则 模板 中 使 用 var 指定 的 名 称 访问 集合 元 素 ， 否 则 使 用 it。 
如 : render template: 'templateName'.collection:Goods.list0. var: 'goods' 
chain 实现 多 个 action 的 链 式 调用 ， 并 维持 每 个 action 的 model 内 容 。 本 质 上 ，chain 方法 
是 用 flash 维持 了 model 的 内 容 ， 然 后 用 redirect 进行 了 跳 转 。 
例如 : 
def first= { 
chain(action:second.model:[one:1]) 
} 
defsecond ={ 
chain(action:third,model:[two:2]) 
} 
def third= { 
[three:3]) 
} 
如 果 访 问 first action， 最 终 的 model 为 [one:1.two:2.three:3]。 
具体 参数 (Map 参数 ) : 
uri、action、controller、id、params: 用 法 与 redirect 相同 ; 
model: 要 传递 给 下 一 个 action 的 model 
withFormat 实现 根据 HTTP 请 求 的 Accept 头 信息 或 URI 的 扩展 名 , 智能 地 输出 不 同 格式 的 数据 。 
例如 : 
def list = { 
def goods = Goods.listO 
withFormat { 
html bookList:books 
js { render "alert('hello)" } 
xXml { render books as XML } 


13.2” 自 定义 URL Mapping 


严格 地 讲 ，URL Mapping 并 不 是 Controller 中 需要 讨论 的 问题 ， 但 因为 Controller 与 
URL 的 关系 是 如 此 的 紧密 ， 所 以 将 对 自 定义 URL 映射 的 问题 ， 安 排 到 了 本 节 进 行 讨论 。 

第 2 单 介绍 过 Grails 的 基础 知识 ，URL 与 Controller 以 及 action 的 对 应 关系 是 : 
“/controllerName/actionName/id”。 事实 上 ,这 个 对 应 关系 也 是 可 以 配置 的 ，Grails 提供 了 自 
定义 URL Mapping 的 方法 : 修改 grails-app\confUrlMappings.groovy， 可 以 改变 URL 的 映 


射 策略 。 默 认 的 UrlMappings.groovy 内 容 如 下 : 


其 中 定义 了 两 条 策略 : "/$controller/$action?/$id?" 表 示 解 析 URL 中 的 Controller、 Action 
和 id， 然后 执行 相应 的 Controller 和 Action 并 传递 id 的 值 ， 而 "500"(view:'/error') 则 表示 ， 
当 执 行 状态 码 为 “500” 时 ， 输 出 error.gsp 页 面 。 这 里 可 以 根据 需要 ， 自 行 配置 URL 的 映 
射 ， 例 如 定义 : 


上 面 这 两 种 写法 是 等 价 的 ， 选 用 哪 一 种 ， 完 全 取决 于 用 户 的 喜好 。 此 时 ， 访 问 /book/1 
与 访问 /goods/show/1?type=book 是 等 价 的 。 

使 用 URL Mappings 时 ,可 能 在 URL 的 匹配 上 ,存在 一 定 的 二 义 性 .例如 ,很 难说 /book/1 
指向 的 是 bookController 的 默认 action， 还 是 goodsController 的 show action。URL 匹配 的 
优先 级 不 是 哪个 配置 项 更 靠 前 ， 而 是 优先 选择 哪 一 个 配置 项 更 “特殊 ”。 

/book/$id 中 包含 了 固定 的 内 容 “book”， 因 而 比 "/$controller/$action?/$id?" 更 特殊 ， 所 
以 会 优先 匹配 /book/$id。 

下 面 再 对 默认 的 "/$controller/$action?/$id?" 进 行 更 深入 的 讨论 , 配置 项 中 也 可 以 定义 与 
Domain 相似 的 约束 条 件 : 


其 中 ，controller、action 和 id 是 预 置 变量 ， 可 以 自动 通过 预 置 变量 将 匹配 结果 传递 给 
Controller、Action 和 id。action 和 id 后 面 的 问号 “?” 表 示 这 两 个 变量 是 可 选 变量 ，URL 


中 可 以 不 包含 该 项 内 容 。 如 果 使 用 闭 包 方式 定义 映射 ， 则 还 可 以 在 闭 包 内 定义 constraints 
对 URL 的 约束 ， 例 如 ， 下 面 的 映射 限制 type 只 能 是 book 或 者 food。 通 过 约束 条 件 ， 也 可 
以 使 URL 的 映射 变 得 更 加 特殊 ， 从 而 实现 优先 使 用 该 规则 进行 匹配 : 


除了 预 置 的 变量 ， 还 可 以 自行 定义 其 他 的 变量 ， 例 如 ， 如 下 格式 可 以 配置 按 日 期 显示 
blog 文章 列表 : 


则 请 求 /blog/2008/9/1， 与 请 求 /blog/search/?year=2008&month=9&day=1 是 等 价 的 ， 但 
显然 第 一 个 URL 对 用 户 更 加 友好 。 

进行 URL 映射 时 ， 还 可 以 使 用 通配符 。 

(1 ) "images/*.jpg"(controllers:"image")， 表 示 所 有 的 /images/*.jpg 都 转 到 image 
controller 中 处 理 。 

(2) "/images/**.jpg"(controllers:"image")， 表 示 所 有 /images/ 下 的 任意 子 目 录 中 的 jpg， 
都 转 到 image controller 中 处 理 。 

(3) Wimages/$name*.jpg"(controllers:"image") 和 I"/images/$name**.jpg"(controllers:"image"), 
表示 转 到 image controller 中 处 理 ， 并 且 jpg 的 文件 名 会 以 params.name 的 形式 传 入 控制 器 中 。 

正如 默认 的 URL Mapping 所 示 ， 可 以 对 状态 返回 码 进行 映射 ; 


除 此 以 外 ， 还 可 以 对 HITP 请 求 的 方法 (method) 进行 映射 : 


使 用 了 URL Mapping, 无 疑 可 以 给 用 户 提供 更 加 友好 的 URL。 但 是 ， 是 否 给 用 户 在 页 
面 上 输出 链接 带 来 麻烦 呢 ? 答案 是 不 会 。g:link 标签 已 经 内 置 了 支持 URL 自动 改写 的 方法 。 
仍 以 blog 的 URL 为 例 ， 如 果 定义 了 blog URL 映射 : 


则 使 用 如 下 方法 构造 链接 : 


这 将 输出 : 
<a href-"/plog/2008/3/1l">article Iistcla> 
怎么 样 ? 是 不 是 很 简单 ? 


13.3 Web Flow 


Grails 从 1.0 开始 就 支持 Web Flow 的 概念 。 它 的 底层 是 依靠 Spring Web Flow 项 目 实 
现 的 !。 使 用 Web Flow， 可 以 轻松 地 编写 有 状态 和 基于 会 话 的 Web 应 用 。 通 过 Web Flow， 
可 以 实现 跨越 多 个 HTTP 请 求 保持 状态 ,Web Flow 应 用 可 以 将 业务 理解 为 一 个 有 穷 状态 机 
不 同 的 事件 会 触发 业务 状态 变化 ，Web 页 面 也 相应 地 从 一 种 状态 变 为 另 一 种 状态 。 

图 13-1 所 示 的 购物 流程 中 主要 描述 简化 的 购物 、 下 单 流程 。 


me 


提示 购买 成 功 


错误 ! 
图 13-1 简化 的 购物 车 工作 流程 
购物 过 程 的 实际 操作 要 比 图 13-1 中 画 的 更 复杂 些 ， 需 要 包含 将 商品 添加 到 购物 车 、 将 


1 Spring Web Flow 是 Spring 框架 的 一 个 子 项 目 。 参 考 http://www.springframework.org/webflow 了 解 详 
细 内 容 。 当 前 版 本 的 Grails 使 用 的 是 Spring Web Flow 2.0ml 的 版 本 ， 这 并 不 是 当前 最 稳定 的 版 本 ， 因 此 
希望 读者 自己 决定 是 否 使 用 Web Flow。 


购物 车 中 商品 删除 、 修 改 购物 车 中 商品 数量 等 内 部 操作 。 如 果 将 整个 购物 过 程 看 成 是 一 个 
flow， 可 以 将 显示 “商品 与 购物 车 “显示 订单 ”等 看 成 是 这 个 flow 中 的 几 个 状态 。 用 户 
的 操作 以 及 业务 的 约束 等 ， 将 触发 应 用 在 不 同 的 状态 间 相 互 转换 。 

Spring Web Flow 就 是 针对 这 样 一 类 需求 而 诞生 的 ， 它 通过 Flow 的 概念 直观 地 将 业务 
上 的 流程 在 Web 应 用 中 体现 出 来 。Grails Web Flow 更 将 Spring Web Flow 的 技术 进行 封装 
和 简化 ， 提 供 一 种 针对 Web Flow 的 DSL， 因 而 无 需 再 编写 繁琐 的 基于 XML 的 Flow 配置 
程序 。 下 面 将 揭 开 Grails Web Flow 的 神秘 面纱 。 

首先 ， 创 建 Flow。 在 普通 的 控制 器 中 创建 名 称 以 “Flow” 结 尾 的 闭 包 ， 例 如 : 


如 果 闭 包 名 称 是 以 “Flow” 结 尾 ， 则 Grails 不 再 把 它 当 作 action 处 理 。 在 创建 Flow 
后 ， 就 可 以 在 Flow 中 定义 状态 。Flow 中 的 一 个 节点 表示 Flow 的 一 个 状态 。 而 Flow 的 第 
一 个 状态 ， 是 Flow 执行 的 入 口 ， 称 为 初始 状态 。 如 果 Flow 中 的 某 些 状态 使 用 redirect 方 
法 跳出 了 Flow， 或 者 不 能 再 转 入 其 他 状态 ， 这 样 的 状态 称 为 结束 状态 。 当 Flow 进入 结束 
状态 后 ， 只 能 重新 进入 Flow 的 初始 状态 ， 而 不 能 再 进入 Flow 的 其 他 状态 。 

Flow 中 的 状态 可 分 为 两 类 : 视图 状态 (View State) 和 操作 状态 (Action State)。 下 面 
分 别 进行 介绍 。 

视图 状态 : 视图 状态 用 于 输出 Web 页 面 ， 在 视图 状态 中 不 能 执行 redirect， 也 不 能 定 
义 action 节点 。 视 图 状态 中 不 能 直接 编写 与 Web Flow 状态 变化 无 关 的 代码 ， 如 查询 数据 
库 ， 但 可 以 在 事件 处 理 时 编写 。 

操作 状态 : 用 于 执行 “操作 ”， 如 查询 、 更 新 数据 库 、 处 理 表单 等 。 操 作 状 态 中 通过 
action 节点 定义 操作 。 

为 了 便于 理解 ， 这 里 在 orderGoods 中 开发 几 个 状态 : 


其 中 listGoods 是 orderGoodsFlow 的 初始 状态 。 通 过 浏览 器 访问 goods/orderGoods， 则 自 
动 进入 listGoods 状态 。 

listGoods 状态 是 一 个 操作 状态 , 进入 listGoods 状态 , 会 自动 执行 action 节点 中 的 程序 ， 
从 而 完成 读 取 购 物 车 和 商品 列表 的 操作 。 当 action 节点 中 的 程序 执行 正确 无 误 时 ， 会 自动 
触发 success 事件 ， 并 转换 当前 状态 为 displayGoodsList 状态 ， 而 当 action 节点 中 的 程序 抛 
出 异常 时 ，on(Exception) 会 被 触发 从 而 跳 转 到 异常 处 理 状态 (页 面 )。 

displayGoodsList 状态 是 一 个 视图 状态 。 默 认 情况 下 ， 进 入 视图 状态 ， 会 输出 GSP 页 
面 〈/grails-app/views/ 控 制 器 名 /Flow 名 /状态 名 .gsp )。 对 于 displayGoodsList， 会 输出 
/grails-app/views/goods/orders/displayGoodsList.gsp 页 面 的 内 容 。 当 然 ， 这 里 也 可 以 使 用 
render 方法 输出 其 他 页 面 ， 例 如 : 


在 使 用 Web Flow 时 ， 作 用 域 的 使 用 变 得 很 重要 。listGoods 状态 的 action 节点 的 返回 
值 会 随 着 状态 变化 的 网 络 传播 到 下 一 个 状态 中 。 于 是 displayGoodsList 对 应 的 GSP 页 面 可 
以 访问 cart 和 goodsList。 

当 Flow 的 执行 进入 视图 状态 ， 就 需要 靠 用 户 的 操作 去 触发 状态 变化 了 。 用 户 可 以 通 
过 单 击 按钮 或 链接 实现 触发 事件 。 

通过 按钮 (本质 上 是 表单 中 加 g:submit): 


其 中 ,表单 (g:form) 的 action 属性 决定 Web Flow 的 名 称 ; g:submitButton 的 name 属性 决 
定 Web Flow 被 触发 的 事件 名 称 。 并 且 ， 在 表单 中 ， 仍 然 可 以 提交 其 他 数据 ， 以 添加 商品 
到 购物 车 为 例 ， 显 然 需要 提交 商品 的 id。 


不 难 想象 ， 在 操作 状态 的 action 节点 中 也 是 通过 params 接收 表单 参数 的 。 
对 于 下 单 事件 ， 可 以 由 单 击 链接 所 触发 : 


与 g:form 的 使 用 相似 ，g:link 的 action 属性 此 时 用 于 指定 Web Flow 的 名 称 。 但 不 同 的 
是 事件 的 名 称 是 通过 event 属性 指定 的 。 根 据 图 13-1 所 示 可 知 ， 在 转换 到 显示 订单 状态 前 
需要 对 购物 车 的 内 容 进 行 检查 ， 只 有 购物 车 内 容 不 为 空 时 才 允 许 进 行 状态 转换 。 有 两 种 实 
现 办 法 ， 一 种 是 先进 入 一 个 操作 状态 ， 在 这 个 状态 中 对 表单 进行 检查 ， 并 根据 检查 结果 进 
入 下 一 步 的 状态 ， 例 如 : 


这 里 的 yes0 和 no0 方 法 触发 了 yes 或 no 事件 '， 与 夯 流 程 图 分 支 逻 辑 时 使 用 的 “是 ”、 
“ 否 ”含义 一 致 。 另 一 种 办 法 是 直接 在 事件 触发 时 执行 检查 操作 : 


注意 ,在 检查 发 现 购物 车 内 没有 商品 时 ， 使 用 error0) 触 发 了 error 事件 。 于 是 当前 的 状 
态 转换 不 会 再 被 执行 。 上 面 的 这 种 做 法 对 于 进行 表单 验证 之 类 的 操作 显得 十 分 方便 。 

接 下 来 ， 深 入 讨论 一 下 Web Flow 中 作用 域 的 问题 。 首 先 需 要 明确 一 点 ，Web Flow 中 
的 每 次 状态 转换 都 执行 了 不 同 的 HTTP 请 求 。 因此 , 不 同 的 状态 之 间 不 能 再 用 request 共享 
数据 。 在 Web Flow 中 ， 可 以 使 用 flow 作用 域 或 者 conversation 作用 域 。flow 作用 域 可 以 


1 从 Grails 的 源 代码 中 可 以 看 到 ， 如 果 在 action 节点 中 执行 一 个 没有 定义 过 的 且 无 参数 的 方法 ， 该 方 
法 就 被 理解 为 触发 了 事件 。 


在 一 个 Web Flow 的 众多 状态 之 间 共 享 数据 ， 而 conversation 作用 域 还 要 更 大 一 些 , 可 以 在 
主 Web Flow 和 子 Web Flow 间 共 享 数据 ( 子 Web Flow 将 会 在 后 面 介绍 )， 例 如 : 


视图 状态 在 调用 GSP 的 时 候 ， 会 自动 将 flow 和 conversation 中 的 数据 合并 到 model 
中 ， 因 而 GSP 页 面 可 以 直接 访问 flow 和 conversation 中 的 数据 。 

本 质 上 讲 ，flow 和 conversation 中 的 数据 不 是 通过 HTTP session 维护 的 ， 而 是 通过 序 
列 化 的 表单 .因而 只 有 实现 了 Serializable 接口 的 类 , 其 实例 才能 存放 到 flow 和 conversation 
中 ， 和 否则 执行 时 会 报错 : 


对 于 操作 状态 ，action 节点 的 返回 值 是 通过 flow 维护 的 ， 因 而 action 也 只 能 返回 实现 
了 Serializable 接口 的 对 象 。 

当 业 务 非常 复杂 时 ， 和 希望 将 其 划分 成 多 个 子 流程 。 每 个 子 流程 可 以 理解 为 全 局 主流 程 
的 一 个 新 状态 ， 如 图 13-2 所 示 。 


二 寺 关 避 购物 车 不 为 空 | 
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图 13-2 将 右 侧 方 框 中 的 几 个 状态 定义 为 一 个 子 流程 
Spring Web Flow 中 通过 “ 子 Web Flow” 的 概念 ， 可 以 支持 这 样 的 子 流程 。 以 提交 订 
单 的 过 程 为 例 ， 将 提交 订单 的 几 个 状态 封装 成 一 个 子 Web Flow。 


二 


orderSubmitFlow 中 包含 了 5 个 状态 。 因 为 listGoods 状态 和 exit 状态 不 能 再 转换 为 其 
他 状态 ， 所 以 它们 是 orderSubmitFlow 的 结束 状态 。 主 Web Flow 中 的 视图 状态 可 以 使 用 
subflow 方法 引用 子 Web Flow。 而 子 Web Flow 的 结束 状态 可 以 成 为 主 Web Flow 中 触发 状 
态 转换 的 事件 : 


为 主 Web Flow 和 子 Web Flow 是 不 同 的 Web Flow， 所 以 无 法 通过 flow 作用 域 共享 
数据 。 需 要 使 用 conversation 作用 域 ， 以 实现 在 主 Web Flow 和 子 Web Flow 间 共 享 数据 : 


13.4 ”本 章 小结 


本 章 对 Controller 和 URL Mapping 进行 了 总 结 性 的 介绍 ， 并 重点 补充 了 前 面 章 节 没 有 


介绍 过 的 Web Flow 的 内 容 。 不 过 在 这 里 提醒 一 下 读者 ， 使 用 Web Flow 的 前 提 是 应 用 比较 
复杂 ， 而 且 有 严格 的 “流程 ”要 求 。 否则， 使 用 Web Flow 不 但 没有 优势 ， 还 会 带 来 更 多 
的 麻烦 。 另 一 方面 ， 由 于 Spring Web Flow 本 身 也 是 一 个 非常 强大 且 完 整 的 框架 ，Grails 并 
没有 封装 它 的 全 部 功能 ， 再 加 上 相关 文档 比较 匮乏 ， 因 此 建议 读者 一 定 要 在 确定 使 用 Web 
Flow 的 功能 前 ， 先 参考 一 下 Spring Web Flow 的 文档 。 有 了 这 些 准 备 , 才能 真正 驾驭 Grails 
Web Flow 并 发 挥 出 它 的 真正 威力 。 


深入 Groovy Server Page 


GSP (Groovy Server Page) 是 Grails 视图 的 默认 输出 方式 。 这 是 一 种 使 用 方式 与 JSP 相 
似 , 但 更 加 灵活 的 页 面 视 图 技术 。 相 信 读 者 读 到 这 一 部 分 的 时 候 ， 应 该 已 经 对 GSP 不 再 陌 
生 了 ， 本 章 就 将 对 前 面 学 习 过 的 GSP 技术 进行 简单 的 小 结 ， 然 后 重点 介绍 自 定义 GSP 标 
签 的 创建 方法 。 


14.1 ”GSP 基础 知识 


14.1.1 GSP 输出 表达 式 


GSP 的 视图 技术 与 JSP 是 非常 相似 的 , 首先 JSP 可 以 在 页 面 中 编写 Java 代码 , 而 GSP 
可 以 在 页 面 中 编写 Groovy 代码 。JSP 与 GSP 代码 都 可 以 写 在 “<% %>” 中 。 
<% 
if( goods) { 
out.print (goods.title) 


out << goods.price //“<<” 是 GSP 中 为 out 重 载 的 运算 符 ， 
// 与 print 方法 含义 相同 


%> 


其 次 在 GSP 和 JSP 中， 都 可 以 用 “<%= %>” 输 出 表达 式 的 值 。 


<%= goods .title %> 等 价 于 <% out << goods.title %> 


GSP 也 支持 部 分 的 JSP 风格 的 页 面 指令 ， 如 : 

<%@ page import="java.awt.*" $%> 

<%@ page contentType="text/json" $> 

然而 , 上 面 的 方法 仅仅 是 为 了 使 熟悉 JSP 的 人 能 够 尽快 上 手 , 并 不 是 GSP 中 推荐 作法 。 
GSP 推荐 用 户 使 用 GString 风格 (${ expr } ) 表达 式 输出 方法 : 


Sfgoods.title} 与 < 和 =goods.title 9> 和 侍从 
14.1.2 ”GSP 中 预定 义 的 变量 与 作用 域 


GSP 中 预定 义 的 变量 与 作用 域 如 表 14-1 所 示 。 
表 14-1 GSP 中 预定 义 的 变量 与 作用 域 


application javax.servlet.ServletContext 实例 。 可 参考 : 
http://java.sun.com/j2ee/1.4/docs/api/javax/servlet/ServletContext.html 

applicationContext ”Spring 容器 : ”org.springframework.context.ApplicationContext 的 实例 。 可 以 
通过 applicationContext 取得 容器 内 的 bean。 可 参考 : 
http://static.springframework.org/spring/docs/2.5.x/api/org/springframework/ 
context/ApplicationContext.html 

out 输出 流 。 用 于 输出 页 面 

flash 与 Controller 中 的 同名 属性 相同 


webRequest 封装 了 Grails 的 Web 请 求 ， 可 参考 : 
http://grails.org/doc/1.0.x/api/org/codehaus/groovy/grails/web/ 
servlet/mvce/GrailsWebRequest.html。 
webRequest 中 包含 了 大 量 的 实用 属性 : 
webRequest.actionName 返回 action 名 称 
webRequest.controllerName 返回 controller 名 称 
webRequest.applicationContext 同 applictionContext 
webRequest.currentRequest 同 request 
webRequest.currentResponse 同 response 
webRequest.parameterMap 同 params 
webRequest.flashScope 同 flash 
webRequest.out 同 out 
webRequest.isFlowRequest() 判断 当前 请 求 是 否 为 flow 请 求 


14.2 ”GSP 标签 库 


曾经 有 不 少 人 以 标签 库 〈taglib) 为 借口 诉 病 GSP， 帮 至 攻击 Grails。 其 实 更 多 的 原因 
是 他 们 不 了 解 GSP 的 taglib， 只 是 想当然 地 把 他 们 已 有 的 JSP 的 知识 套用 在 GSP 上 。 事 实 
上 ，GSP 中 的 taglib 更 加 灵活 ， 也 更 加 简单 。 


GSP 中 的 标签 调用 方式 极为 灵活 : 除了 可 以 按 标签 的 方式 调用 外 ， 还 可 以 按 函 数 的 方 
式 进行 调用 。 对 于 引发 命名 冲突 的 标签 ， 可 以 调用 时 加 上 前 级 ， 如 : 


三 者 完全 等 价 。 
因此 ， 对 于 不 喜欢 标签 的 用 户 ， 完 全 可 以 按照 函数 的 方式 调用 标签 。 此 时 ，GSP 与 
Ruby on Rails 的 thtml 就 十 分 相似 了 。 


14.2.1 ”常用 的 内 置 标签 


借用 JSP 标签 的 概念 ， 将 标签 <xxx>...</xxx> 中 间 的 部 分 称 为 body。GSP 的 常用 内 置 
标签 如 表 14-2 所 示 。 


表 14-2 常用 内 置 标签 


逻辑 判断 站 语义 上 与 Groovy 的 让 .else 完全 一 致 。 
elseif 当 test 属性 为 真 时 !， 输 出 body; 否则 输出 <g:else> 的 body 
else <g: if test="$ {session.user? .type—1}">...</g:if> 


<g:elseif test="$ {session.user?.type—2}">...</g: elseif > 
<g:else>...</g:else> 
其 中 ，elseif 或 else 必需 与 这 联 用 
迭代 each 遍历 集合 : 
<g:each in="${[1.2.3]}" var="num"> 
<li>${num}</i> 
</g:each> 
详 见 第 4 章 
查找 findAll 只 遍历 集合 expr 为 真 的 子 集 。 相 当 于 
<g:each in="$ {books}" var="book"> 
<g:if test="$ {expr}"> 


</g: 论 
</g:each> 


例如 : 
<g:findAll in="$ {books}" 
expr="it.author 一 'Stephen King"> 
<p>Title: $fittitle}</p> 
</g:findAll> 
续 表 


grep 

循环 while 

链接 link 
createLink 
createLinkTo 

变量 赋值 。 set 

输出 模板 Tender 


错误 相关 hasErrors 


对 语 属 性 对 应 的 表达 式 执行 grep 方法 后 返回 的 集合 进行 遍历 。 
例如 : 

<g:grep in="$ {users}" filter="Student.class">... </g:grep> 
等 价 于 Groovy 代码 : 

users.grep(Student.class).each({ ... }) 


filter 的 内 容 还 可 以 是 正则 表达 式 : 
<g:grep in="$ {books*.title}" filter="/(grails)|(groovy)">... </g:grep> 
与 Groovy 中 while 循环 的 语义 相同 。test 属性 为 真 时 ， 执 行 循环 
<g:while test="${ i< 5}"> 
S{it+} 
</g:while> 
参考 第 4 章 ， 输 出 链接 : 
<g:link controller="book" action="show" id="1"> 查 看 </g:link> 
返回 : 
<a href="/book/show/1"> 查 看 </a> 
与 link 标签 使 用 相似 ， 但 只 返回 link 标签 的 href 属性 内 容 。 
<g:createLink controller="book" action="show" id="1"/> 
返回 : 
/book/show/1 
与 createLink 标签 功能 相似 ， 通 常用 于 寻找 静态 资源 。dir 属性 指定 目 
录 ，file 属性 指定 文件 名 : 
<g:createLinkTo dir="css" file="main.css" /> 
返回 : 
/appName/css/main.css 
其 中 appName 指 工程 名 
为 变量 赋值 。 
<g:set var="bookName" value="grails" scope="session"/> 
或 
<g:set var="bookName" scope="session">grails</g:set> 
等 价 于 <% session.bookName = "grails" %> 
其 中 的 scope， 如 果 不 指定 ， 则 默认 为 当前 页 面 中 的 变量 。 
一 般 来 说 ， 更 倾向 于 使 用 Groovy 代码 〈<% %>) 为 变量 赋值 
参考 Controller 中 的 render 方法 
判断 Domain 对 象 是 否 包含 校 验 错误 信息 ， 为 真 时 输出 body。 参 考 第 
5.1 节 。 
<g:hasError bean="goods" field="price" >...</g:hasError> 
输出 Domain 对 象 的 全 部 错误 信息 。 参 考 第 5.1 节 。 
<g:hasError bean="$ {goods}" > 
<g:renderErrors bean—"$ {goods}" /> 
</g:hasError> 


1 这 里 的 真 与 假 ， 指 的 是 Groovy 概念 上 的 真 假 ， 而 非 Java 概念 的 真 假 。 


格式 化 
输出 


il8n 


表单 


eachError 


formatDate 


formatNumber 


message 


sortableColumn 


Paginate 
layoutHead 
layoutTitle 
layoutBody 
pageProperty 


form 


select 


续 表 


遍历 Domain 的 错误 信息 。 参 考 第 5.1 节 。 
<g:hasError bean="${goods}" > 

<u> 

<g:eachError bean—"$ {goods}" > 

<li><g:message error="${it}"/></li> 

</g:eachError> 

<ul> 
</g:hasError> 
使 用 java.text.SimpleDateFormat 格式 化 输出 java.util.Date 类 型 的 日 期 。 例 
如 : 
<g:formatDate format="yyyy-MM-dd" date="$ {date}"/> 
使 用 java.text.DecimalFormat 格式 化 输出 数字 。 例 如 : 
<g:formatNumber number="$ {number}" format="\$###.##0" /> 
输出 il8n 资源 文件 中 定义 的 文本 。 
error: 将 error 对 象 转换 为 消息 文本 ， 用 于 输出 错误 信息 ; 
code: 根据 资源 文件 中 的 key 输出 文本 ， 用 于 输出 自 定义 il8n 文本 ; 
args: 向 资源 文本 传递 参数 ， 可 参考 第 5.1 节 ; 
encodeAs: 对 输出 文本 进行 编码 处 理 ， 如 HTML、JavaScript、URL 等 ， 
也 可 以 使 用 用 户 自 定义 的 Codec， 例 如 第 5 章 定义 的 Password; 
default: 默认 消息 ， 当 资源 文件 中 找 不 到 error 或 code 对 应 的 文本 时 ， 则 
输出 默认 消息 。 
例如 : 
<g:message code="goods.price" encode="HTML" /> 
输出 表 头 ， 包 含 控制 排序 的 链接 。 参 考 第 6.3 节 。 
<g:sortableColumn property="releaseDate" 

defaultOrder="desc" title="Release Date" /> 

输出 分 页 导航 链接 。 参 考 第 5.3 节 。 
<g:paginate controller="goods" total="$ {Goods.countO}" /> 
输出 原始 页 <head></head> 之 间 的 内 容 
输出 原始 页 <title></ title > 之 间 的 内 容 
输出 原始 页 <body></body> 之 间 的 内 容 
输出 原始 页 某 一 元 素 的 属性 值 
<g:pageProperty name="meta.menu" /> 
输出 <form></form>。 可 指定 action、controller、uri， 如 : 
<g:form action="save" controller="goods"> ... </g:form> 
输出 下 拉 列 表 框 。 可 参考 第 4.3 节 。 
from: 非 空 ， 选 项 集合 ; 
value: 可 选 ， 默 认 选中 的 选项 ; 
optionKey: 可 选 ， 设 置 选项 的 key; 
optionValue: 可 选 ， 设 置 选项 的 值 ; 
noSelection: 可 选 ， 用 于 指定 默认 选中 的 选项 。 


续 表 


select 例如 : 


<g:select optionKey="id" optionValue="categoryName" from= 
"${Category.list0}" 

name="category.id" value="$ {goods?.category?.id}" > 
</g:select> 


其 中 optionKey 设置 了 option 的 value 属性 ，optionValue 设置 了 option 的 
值 。 
<option value="$ {category.id}"> 
S${category.cagegoryName} 
</option> 
actionSubmit 。” ”输出 提交 按钮 ， 可 以 指定 接收 请 求 的 action。 
<g:actionSubmit value=" 更 新 " action="Update" /> 
datePicker 下 拉 列 表 框 选取 时 间 日 期 。 
name: 非 空 ， 表 单项 的 名 称 ; 
value: 可 选 ， 默 认 选 中 的 时 间 ， 如 果 不 指定 ， 则 为 当前 时 间 ， 
precision: 可 选 ， 可 选 的 时 间 精 度 ， 包 含 year、，'month'，'day'、'hour` 或 者 
minute'， 默 认为 minute' 
noSelection: 可 选 ， 当 没有 指定 可 选 值 ， 默 认 选 中 显示 的 内 容 (与 select 
标签 使 用 相同 ) ， 例 如 [":'-Choose-"]; 
years: 可 选 的 年 的 范围 ， 可 以 是 Groovy 的 range， 如 ${2001..2008}， 也 
可 以 是 List， 如 ${[2005, 2006. 2008]} 


Grails 中 还 内 置 了 部 分 用 于 Ajax 开发 的 标签 ， 详 见 第 14.3 节 。 


14.2.2 ”开发 自 定义 标签 


回顾 了 GSP 中 常见 的 标签 后 ， 下 面 介绍 如 何 开 发 自 定义 的 标签 。GSP 的 taglib 与 JSP 
相似 ， 但 远 比 JSP 要 简单 与 灵活 ， 它 甚至 支持 在 运行 时 重新 载 入 更 新 。 开 发 自 定义 标签 首 
先 需要 创建 taglib 类 。 可 以 在 控制 台 执行 命令 create-tag-lib 创建 taglib 类 : 


执行 上 面 的 命令 ，Grails 会 在 grails-app\taglib 文件 夹 下 创建 名 为 SimpleTagLib 的 
Groovy 类 。 当 然 ， 用 户 也 可 以 自己 手动 创建 类 似 的 Groovy 类 ， 不 过 类 名 一 定 要 以 Taglib 
结尾 。 创 建 了 TagLib 类 , 接 下 来 就 可 以 开发 具体 的 标签 了 。 标 签 类 中 可 以 访问 的 预定 义 属 
性 包括 : actionName、controllerName、flash、params、request、response、servletContext、 
session。 用 法 与 GSP 中 一 致 ， 这 里 不 再 灼 述 。 

在 TagLib 类 中 添加 如 下 的 闭 包 : 


于 是 ， 可 以 在 GSP 页 面 上 编写 <g:greet /> 或 者 ${fgreet(O} 调 用 该 标签 。 上 面 的 例子 虽然 
简单 ， 也 能 说 明 以 下 一 些 问题 。 

(1) TagLib 类 中 的 每 个 闭 包 对 应 为 一 个 具体 的 标签 。 

(2) 在 GSP 页 面 中 使 用 标签 , 无 需 编写 配置 文件 , 更 无 需 添加 形 如 <%@ taglib prefix=.… 
的 页 面 指令 。 

(3) out 对 象 的 本 质 是 文本 流 , 但 并 不 是 HttpServletResponse 的 输出 流 。 如 果 以 调用 方 
法 的 方式 调用 标签 ， 函 数 的 返回 值 就 是 out 的 内 容 。 因 此 <% greet0 %> 不 会 输出 “hello”， 
而 <%= greet() %> 或 者 ${greet0)} 会 输出 “hello”。 

接 下 来 ， 开 发 更 加 复杂 的 标签 。 

首先 ， 开 发 带 属性 的 标签 : <g:greet name="XXX" />。 

细心 的 读者 可 能 会 注意 到 ， 标 签 闭 包 有 两 个 参数 ， 第 一 个 参数 attrs (Map 类 型 ) 是 标 
签 的 属性 集合 ;第 二 个 参数 body ( 闭 包 类 型 )， 执 行 body0 可 以 得 到 标签 body 的 内 容 。 通 
过 “attrs. 属 性 名 ”， 可 以 访问 到 页 面 给 标签 传递 的 属性 值 : 


于 是 ， 在 页 面 上 调用 <g:greet name="Matt" /> 或 者 ${g.greet(name: "Matt")} 可 以 得 到 


输出 : 
iwmt 


十 分 神奇 的 是 ，name 属性 不 仅 支持 静态 文本 (Matt)， 也 支持 动态 的 内 容 ， 如 : 


而 读者 无 需 去 关心 究竟 goods.title 的 值 是 如 何 取出 的 。 
下 一 步 ， 开 发 支持 body 的 标签 ， 如 : <g:greet>Matt</g:greet>。 正 如 前 面 所 述 ， 只 需要 
执行 body0， 就 可 以 得 到 标签 body 的 内 容 。 


<g:greet>Matt</g:greet> 将 输出 Hello Matt。 千 万 不 要 小 看 body 闭 包 的 威力 ， 虽 然 只 是 
简单 地 进行 一 下 调用 ， 但 可 以 支持 无 限 复杂 的 标签 内 容 的 解析 执行 ， 甚 至 包括 嵌 套 标签 的 


Bd 


假设 goods.title 的 内 容 为 Groovy， 则 上 面 的 标签 将 输出 : 


某 些 情况 下 ， 标 签 需要 向 其 body 传递 参数 。 例 如 each 标签 ， 它 需要 将 每 次 遍历 取出 
的 对 象 传递 给 body 内 容 。 传 递 的 方法 十 分 简单 ， 在 调用 body 闭 包 时 传 入 参数 即 可 。 

下 面 举例 说 明 问 题 ， 设 计 一 个 执行 循环 的 标签 ， 包 含 3 个 属性 : 初始 值 start、 结 束 值 
end、 单 步 值 step。 假 设 当前 只 支持 整数 循环 ， 实 现代 码 如 下 : 


上 面 的 代码 为 了 简单 ,没有 做 有 效 性 检查 , 正常 情况 需要 先 判断 start 和 end 是 否 为 null。 
其 中 的 body() 实 现 了 将 数据 传 入 标签 的 body 中。 但 是 ， 由 于 没有 指定 数据 在 body 中 的 名 
称 ， 此 时 body 中 的 代码 只 能 使 用 “it” 访 问 传 入 的 数据 : 


模仿 Grails 提供 的 each 标签 ， 这 里 也 加 入 var 属性 ， 使 用 户 可 以 自己 定义 body 中 使 
用 的 变量 名 : 


此 时 ， 调 用 body 闭 包 时 ， 需 要 传 入 Map，Map 的 key 决定 body 代码 访问 传 入 数据 的 
变量 名 ,而 Map 的 value 决定 了 传 入 数据 的 内 容 。 这 里 应 该 注意 一 点 ，Map 必须 写成 [(var):i] 
而 不 是 [var:]， 因 为 [var:] 永 远 表示 Map 的 key 是 字符 串 “var”。 

此 时 的 forLoop 标签 调用 方法 如 下 : 


读者 会 注意 到 ， 自 定义 的 标签 在 默认 情况 下 也 被 放 到 了 Grails 默认 的 命名 空间 
(namespace)“g” 中 。 事 实 上 ， 可 以 自己 定义 标签 的 命名 空间 ， 只 需要 在 标签 类 中 定义 静 
态 属性 namespace: 


此 时 调用 标签 的 写法 为 : 


| 


14.3 ”Grails 对 Ajax 的 支持 


默认 情况 下 ，Grails 是 通过 JavaScript 的 framework“Prototype ”对 Ajax 提供 了 支持 。 
它 提供 了 一 些 标签 , 可 以 简化 开发 Ajax 应 用 的 任务 。Grails 标签 简化 开发 的 核心 思想 就 是 : 
后 台 提交 一 个 请 求 (HttpXmlRequest)， 当 请 求 完成 时 ， 更 新 页 面 上 的 一 部 分 内 容 。 

Grails 的 标签 实现 后 台 提 交 请 求 主 要 有 3 种 方式 : remoteLink、formRemote 和 


submitToRemote， 下 面 将 分 别 进行 介绍 。 

通过 remoteLink 构造 链接 ， 单 击 该 链接 ， 会 执行 请 求 ， 并 在 请 求 成 功 后 更 新 页 面 内 的 
元 素 。 以 添加 购物 车 为 例 〈 不 能 使 用 Web Flow 的 版 本 )， 单 击 链接 ， 将 商品 放 入 购物 车 ， 
并 更 新 购物 车 内 容 。 

GSP 页 面 的 链接 为 : 


其 含义 为 ， 当 addToCart action 执行 完毕 后 ， 用 其 返回 内 容 (HTML 页面 ) 更 新 当前 
页 面 上 id 为 shoppingCart 的 元 素 (<div id="shoppingCart"> </div>)。 因 此 ， 还 需要 修改 页 
面 ， 使 购物 车 内 容 存 放 到 <div id="shoppingCart"> 中 : 


相应 的 Controller 中 的 addToCart action 也 要 做 一 些 修改 ， 从 而 将 购物 车 的 内 容 输出 到 
页 面 上 : 


添加 到 购物 车 的 逻辑 已 经 改造 完成 。 不 需要 刷新 页 面 就 可 以 将 商品 添加 到 购物 车 中 。 
而 从 购物 车 中 移 除 商品 和 修改 购物 车 中 商品 数量 的 逻辑 ， 也 可 以 进行 改造 。 修 改 购物 车 中 
商品 数量 ， 用 submitToRemote 标签 进行 改造 : 


将 原来 的 submit 按钮 蔡 换 成 submitToRemote 标签 ， 可 以 实现 后 台 提交 表单 ， 并 在 执 
行 完成 后 更 新 指定 的 页 面 元 素 id (update="shoppingCart")。 
从 购物 车 中 移 除 商品 的 逻辑 ， 不 妨 用 formRemote 标签 进行 改造 : 


将 form 标签 蔡 换 成 g:formRemote 标签 (要 注意 接收 表单 的 url 的 写法 )， 并 指定 要 更 
新 的 元 素 id Cupdate="shoppingCart") 即 可 。 

改造 完 页 面 , action 的 程序 也 需要 进行 修改 以 输出 购物 车 。 和 addToCart 的 改造 原理 相 
同 ， 将 原来 的 redirect 换 成 render 即 可 : 


虽然 使 用 Grails 提供 的 标签 可 以 提高 Ajax 的 开发 效率 ,但 不 管 怎么 说 ，Server 端的 框 
架 ， 对 客户 端 脚本 的 封装 总 是 有 限 的 。 想 完全 不 写 JavaScript 就 开发 出 具有 完美 用 户 体验 
的 Web 应 用 是 不 现实 的 ，JavaScript 就 像 HTML CSS 一 样 ， 都 是 进行 Web 开发 的 必 备 的 
基础 。 


14.4 ”本 章 小 结 


本 章 首 先 对 GSP 的 知识 点 进行 了 总 结 , 然后 着 重 介 绍 了 如 何 开发 自 定义 的 GSP 标签 。 
本 章 的 最 后 部 分 对 在 GSP 中 开发 Ajax 的 常用 标签 进行 了 介绍 。 


ee 


Web Service 本 质 上 是 要 实现 远程 的 程序 调用 。 当 前 ，SOA 的 概念 非常 流行 ， 但 从 技 
术 层面 来 讲 ， 并 无 太 多 创新 之 处 ， 本 质 上 都 是 基于 某 种 通用 的 远程 调用 技术 。Grails 作为 
新 兴 的 一 栈 式 快速 Web 开发 框架 ， 自 然 对 REST、SOAP 等 技术 提供 了 良好 的 支持 。 


15.1 REST 风格 的 Web Service 


15.1.1 什么 是 REST 


REST (Representational State Transfer， 表 述 性 状态 转移 ) 是 Roy Fielding 博士 于 2000 
年 在 他 的 博士 论文 中 提出 来 的 一 种 软件 架构 风格 。REST 是 一 种 设计 风格 而 不 是 一 个 技术 
标准 ， 它 通常 基于 HITP、URI、XML 以 及 HTML 这 些 现 有 的 广泛 流行 的 协议 和 标准 四 四 。 

REST 从 资源 的 角度 来 观察 整个 网 络 ， 分 布 在 各 处 的 资源 由 URI 确定 ， 而 客户 端的 应 
用 通过 URI 来 获取 资源 的 表 形 。 随 着 不 断 获取 资源 的 表述 ， 客 户 端 应 用 不 断 地 在 转变 着 其 
状态 ， 这 就 是 所 谓 的 表述 性 状态 转移 。 

REST 定义 了 应 该 如 何 正确 地 使 用 (这 和 大 多 数 人 的 实际 使 用 方式 有 很 大 不 同 ) Web 
标准 ， 例 如 HITP 和 URI。 如 果 在 设计 应 用 程序 时 能 坚持 REST 原则 ， 那 就 预示 着 将 会 得 
到 一 个 使 用 优质 Web 架构 的 系统 。REST 的 5 条 关键 原则 列举 如 下 : 

(1) 为 所 有 “事物 ”定义 ID; 

(2) 将 所 有 事物 链接 在 一 起 ; 

(3) 使 用 标准 方法 ; 

(4) 资源 的 多 重 表述 ; 

(5) 无 状态 通信 。 


15.1.2 在 Grails 中 实现 REST 


由 于 REST 本 身 并 不 表示 具体 的 技术 ， 而 体现 为 一 种 范式 或 者 思想 。 就 以 上 提 到 的 5 
点 ， 在 Grails 中 需要 通过 技术 手段 支持 的 是 “使 用 标准 方法 ”和 “资源 的 多 重 表述 ”。 

在 Grails 中 实现 这 两 点 并 不 复杂 。 主 要 基于 Grails 提供 的 URL Mapping、XML 与 JSON 
输出 、XML 格式 的 表单 参数 解析 、 内 容 协商 4 个 基本 功能 。 


“使 用 标准 方法 ”是 通过 URL Mapping 技术 实现 的 。 使 用 不 同 的 方法 对 资源 进行 请 求 
时 ， 将 调用 不 同 的 action， 从 而 执行 不 同 的 具体 行为 ， 例 如 : 


此 时 ， 当 客户 端 〈 即 调用 服务 的 程序 ， 如 浏览 器 、JavaScript 程序 以 及 其 他 支持 HTTP 
请 求 的 程序 ) 分 别 使 用 GET、PUT、DELETE、POST 方法 请 求 /goods/$id 这 一 URI 时 ， 
Controller 会 相应 地 执行 show、update、delete 和 save action 。 

“资源 的 多 重 表述 ”要 求 能 够 以 多 种 形式 (格式 ) 输出 资源 ， 而 Controller 中 提供 了 便 
捷 的 以 XML 和 JSON 等 格式 输出 数据 的 方法 。 


此 时 ,show action 会 以 XML 的 形式 ,返回 对 应 的 商品 信息 。Grails 还 可 以 通过 Controller 
的 withFormat 方法 ， 实 现 根据 与 Client 的 协商 结果 返回 需要 资源 的 格式 。 


此 时 ， 可 以 根据 Client 请 求 的 HITP 头 信息 中 的 Accept 指定 接收 类 型 ， 也 可 以 根据 
URI 的 扩展 名 (如 /goods/1.xml), 还 可 以 根据 format 参数 指定 接收 类 型 (如 /goods/1?format 
=xml)。 

“资源 的 多 重 表述 ”还 有 很 重要 的 一 个 要 求 ， 就 是 支持 XML 格式 的 数据 提交 。 以 save 
action 为 例 ， 如 果 Client 希望 保存 一 条 goods 的 记录 ， 将 会 提交 如 下 的 XML 数据 : 


相应 地 ，Controller 中 接收 数据 程序 代码 也 是 不 可 思议 的 简单 。 原 来 ，Controller 中 的 
params 可 以 接收 XML 格式 的 数据 ， 如 : 


15.1.3 在 Client 端 调 用 服务 


从 本 质 上 讲 ，REST 方式 发 布 的 服务 就 是 基于 HTTP 请 求 的 Web 资源 ，Client 可 以 通 
过 HTTP 请 求 访问 资源 ， 从 而 相当 于 对 服务 的 调用 。 这 里 以 Java 开发 客户 端 进行 说 明 。 
GET 方式 请 求 资源 : 


POST 方式 保存 资源 : 


PUT 方式 和 DELETE 方式 与 POST 类 似 , 只 需要 在 conn.setRequestMethod(O) 指 定 HTTP 
方法 为 "PUT"、"DELETE"。 


15.2 ”基于 SOAP 的 传统 Web Service 


SOAP (Simple Object Access Protocol, 简单 对 象 访问 协议 ) 方式 的 Web Service 是 Web 
Service 传统 实现 方式 ， 也 得 到 很 多 大 公司 的 支持 。SOAP 是 一 种 标准 化 的 通信 规范 ， 主 要 
用 于 Web Service 中 。SOAP 的 出 现 是 为 了 实现 不 同 应 用 程序 之 间 能 够 通过 HTTP 协议 ,以 
XML 格式 进行 交互 ,使 其 与 编程 语言 平台 和 硬件 无 关 。 此 标准 由 IBM、Microsoft、UserLand 
和 DevelopMentor 在 1998 年 共同 提出 ， 并 得 到 IBM、Lotus、Compaq 等 公司 的 支持 ， 然 后 
于 2000 年 提交 给 W3C。 目 前 的 SOAP 仍然 是 业界 的 标准 ， 属 于 第 二 代 的 XML 协 义 (第 
一 代 有 代表 性 的 技术 为 XML-RPC 以 及 WDDX)。 

Grails 内 置 没有 提供 对 SOAP 的 支持 , 但 可 以 通过 插件 很 好 地 支持 SOAP。XFire 插件 
使 用 开源 的 XFire 框架 ， 其 突出 的 特点 就 是 简单 快捷 。 

使 用 XFire 插件 :， 可 以 将 Grails 中 创建 的 service 发 布 成 为 Web Service， 例 如 : 


此 时 访问 http://localhost:8080/GDepot/services/goods?wsdl (注意 URL 与 Service 名 称 
的 对 应 关系 )， 可 以 看 到 该 服务 的 WSDL 的 内 容 ， 如 图 15-1 所 示 。 

到 此 ， 发 布 服务 的 任务 已 完成 ， 并 且 可 以 在 Client 端 进行 调用 了 。 调 用 Web Service 
的 方法 和 步骤 与 普通 的 Java 程序 并 无 太 大 区 别 ， 这 里 不 再 次 述 。 


: 插件 的 安装 和 使 用 ， 见 下 一 章 。 


一 人 sdl :definitions targetNamespace= “http://DefanltNamespace 》 


xsd:schema attributeFormDefault-"qualified” elenentFormDefault- quslified” targetNamecpace-"http://DefeultNamespace’> 
一 4xsd:element name="getGoodsList”> 
xsd:complexType/> 
/xsd:element> 
-txsd:complexType name= “hrray0fGoods > 
rsd:scqucnce> 
《xsd:element maxQccurs="unbonded” ninOccurs="0” nane="Goods” nillable="true” type="tns:Goods"/》 
/xsd:sequence) 
/xsd:conplerType> 
一 《xsd:complexType name= ”Goods 
-xsd:sequence> 
《zsd:element min0ccurs- 0”namce= category”millable= “true”type= tns:Category /> 
《xsd:element min0ccurs=“0”name=“description”nillable= "true”type= rsd:string /> 
xsd:element min0ccurs=“0”name= “id” nillable= “true”type= “zsd:long /> 
《xsd:element min0ccurs=“0”name= "photoUrl”nillable=“true”type= "xsd:string"/》 
<xsd:element min0ccurs= “0”name= “price”nillable= “true” type= xsd:decinal /> 
《xsd:element minQccurs="0” name="title” nillable="true” type="xsd:strine’/> 
/xsd:sequence) 
/xsd:conplexType> 
一 《xsd:complexType name="Catescry”> 
-xsd:sequence> 
<xsd:element minQccurs="0” name="catesoryliane” nillable= true” type="xsd;string’/) 
《xsd:element min0ccurs=“0”name=“goods”nillable=“true”type="tns:hrray0fGonds /> 
《zad:element min0ccurs= “0”name= id”nillable= “true”type= xcd:long /> 
/xsd:sequence) 
/xsd:conplexType> 
-txsd:elenent name=“getGoodsListResponse 
-xsd:complexType) 
-xad:gcquence> 
xsd:element maxOccurs="1” minOccurs="1” name=“out” nillable="true” type="tns:hrrayOf?onds”/> 
/xsd:sequence> 
/xsd: complexType> 


/nsdl :types> 


15-1 使 用 firefox 浏览 Web Service 


15.3 “本章 小 结 


本 章 介绍 了 Web Service 相关 的 技术 ， 包 括 REST 方式 以 及 传统 的 SOAP 方式 。Grails 
还 提供 了 一 些 插件 ， 可 以 实现 对 其 他 的 一 些 远程 调用 技术 进行 整合 。 例 如 ，xmlrpc、RMI、 
Hessian、Burlap、Spring's HttpInvoker 等 。 


| Os 


Grails 是 一 个 一 栈 式 的 框架 ,希望 能 够 解决 Web 开发 中 多 方面 的 问题 。 但 是 技术 在 不 
停 地 革新 变化 ,封闭 体系 永远 不 可 能 做 到 “包罗 万 象 "。 因此， 插件 扩展 成 为 Grails 的 一 个 
重要 特性 ， 它 的 存在 成 就 了 Grails 几乎 无 限 的 扩展 可 能 。 正 因为 如 此 ， 读 者 有 必要 学 习 一 
下 Grails 的 插件 机 制 ， 了 解 常用 的 插件 ， 并 掌握 一 定 的 插件 开发 技能 。 

由 于 开发 Grails 插件 需要 有 高 级 的 Groovy 知识 做 基础 ， 本 章 暂 不 介绍 如 何 开 发 Grails 
插件 。 相 关 的 知识 将 在 本 书 的 最 后 部 分 进行 介绍 。 


16.1 ”插件 的 安装 


Grails 提供 了 大 量 插件 ， 涉 及 安全 、UI、Web Service、 性 能 、 测 试 、 调 试 等 多 个 方面 。 
通过 官方 网 站 可 以 看 到 插件 列表 中 ， 如 图 16-1 所 示 。 


则 SRAILS 


Grails Plugins 


bleach olegn at ls analzbe or crale Falaeangrourom 


sea bondionai 


ohumate sacaton fom the PitNesse 


16-1 官方 网 站 列 出 插件 的 页 面 


naoenal and accsernce Est 


使 用 Grails 的 命令 行 也 可 以 查看 在 线 的 插件 资源 ，list-plugins 命令 可 用 于 查看 插件 列 
表 !。list-plugins 命令 在 读 取 插件 信息 后 会 显示 : 插件 名 < 当前 最 新 版 本 号 >-- 简 单 插件 描述 。 


! 执行 list-plugins 命令 要 求 计算 机 能 够 访问 intemet。 


犹 隐 再三， 选择 了 保留 全 部 list-plugins 命令 执行 时 的 输出 结果 。 因 为 没有 什么 能 比 这 


个 更 能 反映 当前 Grails 插件 的 繁荣 程度 了 。 当 然 在 面 对 大 量 的 插件 时 ， 没 有 必要 感到 无 所 
适 从 ， 毕 竟 插 件 存在 的 目的 就 是 帮助 用 户 解决 问题 或 者 简化 问题 。 查 看 插件 列表 后 ， 可 以 
使 用 plugin-info 命令 查看 插件 的 详情 。 如 : 


在 确定 要 在 项 目 中 使 用 某 一 插件 后 ， 则 需要 安装 插件 ， 可 以 使 用 install-plugin 命令 安 
装 插件 。install-plugin 命令 非常 强大 ， 能 够 完成 对 插件 的 下 载 和 安装 ， 也 支持 安装 本 地 的 
插件 程序 。 使 用 格式 如 下 : 


如 果 不 指定 版 本 号 ， 则 安装 当前 最 新 的 稳定 版 本 。 
16.2 ”插件 的 组 织 结构 


每 一 个 Grails 的 插件 更 像 是 一 个 “小 ”的 Grails 应 用 。 它 的 组 织 结构 如 图 16-2 所 示 。 


Fay acegi-0.4.1 


| 上- 图 Acegicrsilsplugin goovy 
| 由 application properties 


图 16-2 ”Grails 插件 的 组 织 结构 


可 以 看 出 ， 每 个 插件 都 可 以 有 它 自己 的 配置 文件 、 控 制 器 、Service、 标 签 库 、 自 定义 
命令 (Script) 以 及 测试 程序 等 。 但 一 般 来 说 ，Grails 插件 中 并 不 包含 下 面 的 内 容 : 


对 于 UrlMappings.groovy， 如 果 读者 希望 在 插件 中 自己 定义 Ud 映射 ， 可 以 定义 为 
XXXUrlMappings.groovy， 例 如 BlogUrIMappings.groovy。 而 对 于 希望 安装 到 web-app\ 
WEB-INF\ 目 录 中 的 内 容 ,推荐 的 做 法 是 修改 scripts\ Install.groovy (Gant 脚本 ), 将 它们 安 


装 到 全 局 应 用 程序 的 web-app\WEB-INF\ 中 。 
接 下 来 ， 介 绍 几 个 常见 插件 的 使 用 。 


16.3 插件 的 使 用 


16.3.1 Acegi 插件 


Acegi 是 Spring 项 目的 一 个 子 项 目 ， 更 新 到 2.0 时 这 个 项 目 被 更 名 为 Spring Security。 
Grails 的 Acegi 插件 ， 虽 然 名 称 仍 为 Acegi， 但 本 质 上 是 对 Spring Security2.0 进行 了 封装 。 
使 用 Acegi 插件 ， 可 以 方便 地 解决 权限 分 配 、 权 限 验证 等 一 系列 与 安全 相关 的 问题 。 

首先 ， 需 要 安装 Acegi 插件 : 


Grails 会 完成 下 载 ， 并 执行 解压 、 编 译 、 安 装 等 一 系列 动作 。 如 果 下 载 速度 太 慢 ， 不 
妨 使 用 其 他 下 载 工具 下 载 , 下 载 地 址 为 : http://plugins.grails.org/grails-acegi/tags/(RELEASE_ 
0 _4_l/grails-acegi-0.4.1.zip。 下 载 完成 后 使 用 命令 grails install-plugin D:\grails-acegi-0.4.1.zip 
进行 安装 (假设 该 插件 文件 存放 在 DD 盘 根 目录 )。 

Spring Security 解决 的 是 用 户 、 角 色 、 资 源 之 间 的 关系 。 用 户 与 角色 是 多 对 多 的 关系 ， 
角色 与 资源 (权限 ) 也 是 多 对 多 的 关系 。 它 们 之 间 的 关系 可 以 通过 多 种 方式 进行 存储 ， 例 
如 数据 库 、 静 态 配置 文件 等 。 

其 次 ， 使 用 插件 提供 的 命令 来 创建 用 户 、 角 色 以 及 资源 的 Domain。 命 令 格式 如 下 : 


其 中 的 AuthUser 是 用 于 注册 和 登录 的 “用 户 ”Domain， 而 Role 则 对 应 为 角色 类 。 命 
令 成 功 执行 后 ， 会 创建 几 个 Groovy 文件 ， 分 别 是 AuthUsergroovy、Role.groovy、 
Requestmap.groovy 三 个 Domain 类 和 SecurityConfig.groovy 配置 文件 ， 以 及 login 和 logout 
两 个 controller。 

用 户 类 的 内 容 如 下 : 


角色 类 的 内 容 如 下 : 


从 两 个 类 的 内 容 也 可 以 看 出 它们 之 间 存 在 多 对 多 的 关系 。 

Requestmap 类 描述 了 资源 与 角色 的 关系 , 但 是 它 没有 使 用 数据 库 中 的 多 对 多 关系 ， 因 
为 那样 显得 有 些 过 于 复杂 。 事实 上 ,Requestmap 只 是 记录 了 url 和 用 逗号 分 隔 的 多 个 角色 。 
Requestmap 的 内 容 如 下 : 


虽然 有 了 上 面 的 Domain 类 ， 用 户 已 经 可 以 自己 实现 按 角 色 分 配 资源 ， 并 且 将 分 配方 
式 记录 在 数据 库 中 ， 但 是 Acegi 插件 提供 了 更 简便 的 方法 ， 使 用 generate-manager 命令 可 
以 自动 生成 维护 用 户 -角色 -资源 的 页 面 : 


命令 执行 成 功 ， 会 自动 生成 如 下 内 容 : 


此 时 ， 可 以 分 别 使 用 User、Role、Requestmap 的 CRUD 页 面 进 行 查看 、 添 加 、 修 改 
和 删除 。 首 先 访问 http:Wlocalhost8080/GDepot/role/create, 并 创建 两 个 Role: user 和 admin， 


如 图 16-3、 图 16-4 所 示 。 


GAAIES 


全 Home 国 Roleuist 
Create Role _ 


Role Name: ser 


Description | 归 认 的 用 户 对 象 | 


ET 


16-3 创建 user 角色 


> GBRIES | 


全 Home 加 | Role uist 
Create Role 
Role Name: [admin 


ssenpton [管理 员 对 象 


国 ceae 


图 16-4 创建 admin 角色 


然后 ， 使 用 http://localhost:8080/GDepot/requestmap/create 配置 限制 访问 的 资源 ， 如 图 
16-5 所 示 。 


Create Requestmap 
Wn /admin/™* 
Role (comma-delimited): am 
轴 create 
图 16-5 配置 Requestmap 
此 时 ,任何 /admin/ 下 的 资源 ,都 需要 有 admin 角色 才能 访问 。 接 下 来 ,使 用 http:/localhost: 
8080/GDepot/user/create 页 面 创建 一 个 用 户 ， 只 为 它 配 置 user 角色 ， 如 图 16-6 所 示 。 


Create AuthUser 


Login Name; 


mame 。 率 = 
Paseword; [vov0o0 

Enabled: 后 

Description: 

Ni zhangsan@gmail.com 
Show Email; 后 

Assign Roles: 

admin 三 

user [3 

品 coe 


图 16-6 创建 user 角色 的 用 户 


然后 使 用 该 用 户 登 录 http://localhost:8080/GDepot/login/auth， 登 录 成 功 后 ， 可 以 发 现 ， 
此 时 并 不 能 访问 /admin/ 下 面 的 资源 ， 如 图 16-7 所 示 。 


HTTP ERROR: 403 


Access is denied 
RequestURI=/GDepot/admin fistGoods 
Powered by Jett 


图 16-7 访问 http://localhost:8080/admin/listOrders 时 报错 


而 当 使 用 拥有 admin 角色 的 用 户 登录 时 ， 就 可 以 访问 该 页 面 了 。 


有 的 时 候 并 不 需要 动态 地 配置 资源 和 角色 对 应 关系 , 此 时 可 以 在 SecurityConfig.groovy 
中 静态 地 进行 配置 : 


在 UI 上 创建 user 角色 ， 它 存放 到 数据 库 的 名 称 就 是 ROLE_USER; 同 理 ，admin 角色 
在 数据 库 中 的 名 称 就 是 ROLE_ ADMIN.。 

回顾 图 16-6 创建 用 户 ， 显 然 那个 页 面 是 不 能 给 普通 用 户 使 用 的 ， 因 为 不 可 能 允许 普通 
用 户 自行 配置 角色 。 这 里 需要 为 普通 用 户 单独 开发 一 个 用 于 注册 的 页 面 。acegi 插件 的 
generate-registration 命令 可 以 帮助 完成 这 个 任务 : 


运行 成 功 后 ， 会 自动 生成 如 下 文件 : 


这 个 自动 生成 的 注册 页 面 实 际 上 是 非常 完善 的 ， 它 包含 两 次 输出 密码 、 验 证 码 等 ， 访 
问 http://localhost:8080/GDepot/register， 可 看 到 如 图 16-8 所 示 的 注册 页 面 。 


User Registration 
Login Name: 一 


图 16-8 自动 生成 的 注册 页 面 


怎么 样 ? 是 不 是 后 悔 在 第 6 章 中 自己 手动 开发 用 户 注册 的 功能 了 ? 从 生成 的 
Controller 可 以 看 到 ， 使 用 注册 页 面 注 册 的 用 户 会 被 标记 为 默认 角色 : 


而 默认 角色 是 在 SecurityConfig.groovy 中 定义 的 : 


通过 Acegi 插件 提供 的 命令 ， 可 以 完成 用 户 登录 、 角 色 创 建 、 角 色 分 配 、 资 源 配 置 等 
功能 。 但 与 权限 相关 的 问题 总 是 很 复杂 的 ， 上 面 的 功能 还 不 能 解决 全 部 的 问题 。 有 的 时 候 ， 
可 能 需要 在 同一 个 页 面 上 对 不 同 角色 的 用 户 显示 不 同 的 内 容 。Acegi 插件 提供 了 几 个 标签 ， 
用 于 识别 角色 、 登 录 等 。 这 几 个 标签 的 介绍 如 表 16-1 所 示 。 


表 16-1 Acegi 标签 库 


ifAllGranted 判断 当前 用 户 是 否 拥 有 角色 〈 和 角色 是 以 “.” 分 隔 的 列表 ) : 

ifAnyGranted 

ifNotGranted ifAllGranted 判断 当前 用 户 是 否 拥有 全 部 角色 : 
<g:ifAllGranted role="ROLE_USER.ROLE ADMIN"> 
这 是 只 有 ROLE_USER 或 ROLE_ADMIN 才能 看 到 的 文本 。 
</g: ifAllGranted> 


ifAnyGranted 判断 当前 用 户 是 否 拥有 某 一 角色 : 

<g: ifAnyGranted role="ROLE USER.ROLE ADMIN"> 
这 是 ROLE_USER 或 ROLE_ADMIN 都 能 看 到 的 文本 。 
</g: ifAnyGranted> 


ifNotGranted 判断 当前 用 户 是 不 是 不 能 拥有 某 一 角色 : 

<g: ifNotGranted role="ROLE USER.ROLE ADMIN"> 

这 是 除了 ROLE_USER 和 ROLE_ADMIN 都 能 看 到 的 文本 。 
</g: ifNotGranted> 


续 表 
isLoggedIn 判断 是 否 登录 
isNotLoggedIn <g:isLoggedIn> 
您 是 已 登录 的 用 户 
</g: isLoggedIn> 


<g:isLoggedIn> 
您 还 没有 登录 
</g: isLoggedIn> 


除了 上 面 的 标签 ，Acegi 插件 还 提供 了 一 个 Service 类 (AuthenticateService )， 该 类 包 
含 了 一 些 非 常 实 用 的 方法 : 


一 般 来 说 ， 设 计 真 正安 全 的 系统 ， 就 需要 系统 各 层 都 是 安全 的 。 因 此 ， 还 需要 保证 业 
务 逻 辑 层 同样 安全 。Acegi 插件 还 提供 了 为 Service 类 方法 定义 访问 角色 的 功能 ， 其 使 用 方 
式 是 在 需要 安全 检查 的 方法 前 添加 Annotation: 


例如 ， 配 置 admin 可 以 访问 methodA， 而 配置 user 可 以 访问 methodB: 


有 了 上 面 的 基础 ， 就 可 以 实现 动态 控制 (或 者 静态 配置 ) 用户、 角色 、 资 源 的 关系 ; 


也 可 以 精细 地 控制 某 一 个 细小 的 功能 点 属于 哪个 角色 。 这 就 已 经 可 以 解决 绝 大 多 数 常见 的 
与 权限 控制 相关 的 需求 了 。 但 Spring Security 还 有 更 多 的 功能 ， 它 还 支持 除数 据 库 登录 认 
证 外 的 多 种 认证 方式 : LDAP、Openld 等 。 感 兴趣 的 读者 可 以 参考 http://static.spring 
framework.org/spring-security/site/index.html。 


16.3.2 ”Debug 插件 


正如 前 面 所 述 ， 不 同 的 插件 解决 不 同 领域 的 问题 。Acegi 插件 可 以 解决 与 安全 相关 的 
问题 。 而 Debug 插件 可 以 简化 调试 的 任务 。Debug 插件 是 一 个 很 小 的 插件 ， 但 功能 却 非常 
实用 。 安 装 Debug 插件 的 命令 为 : 


Debug 插件 默认 支持 两 种 方式 输出 调试 信息 : 在 控制 台 输出 和 在 页 面 输 出 。 如 果 希 望 
在 控制 台 输 出 调试 信息 ， 需 要 先 开 启 log4 中 相应 的 配置 。 首 先 ， 在 项 目的 Config.groovy 
文件 中 添加 : 


然后 在 Config.groovy 文件 中 配置 希望 Debug 插件 记录 的 调试 信息 。 目 前 , Debug 插件 
支持 下 面 8 种 调试 信息 : 


可 以 根据 需要 ， 自 行将 上 面 的 一 种 或 几 种 调试 信息 添加 到 Config.groovy 中 ， 此 时 ， 控 
制 台 上 会 输出 相应 的 内 容 。 
Debug 插件 也 提供 在 页 面 上 输出 调试 信息 的 办 法 ， 只 需要 简单 地 写 一 个 标签 : 


输出 效果 如 图 16-9 所 示 。 
如 果 希 望 在 项 目 中 禁用 Debug 插件 ， 需 要 在 Config.groovy 中 添加 配置 项 : 


由 于 Debug 插件 会 输出 大 量 的 调试 信息 ， 如 果 在 生产 环境 中 使 用 , 会 带 来 严重 的 性 能 
下 降 。 插 件 的 作者 考虑 到 这 一 点 ， 因 而 Debug 插件 默认 不 会 在 生产 模式 下 运行 。 如 果 需 要 
在 生产 模式 下 运行 ， 需 要 在 Config.groovy 中 添加 配置 项 : 


| Keep-Alive 

1DSESSIONID=11kuutjzswrak 

| localhost:8080 

| htp://iocahost:8080/GDepot 
x86 

| Mozila/4.0 (compatiole; MSIE 7.0; Windows NT 6.0; SLCC1; .NET CLR 2.0.50727; Media Center PC 5.0; NET CLR 3.0.04505; 360SE) 


tiributes 
| value 


时 
org,codehaus.groovy grais.FLASH_SCOPE | Instance of dass org.codenaus.groovy.grails.web.serviet.GraisFlashScope 
userld 


Re 

Name |Value 

requestStart 。 | Fri Sep 26 23:07:00 CST 2008 
requestHonded | Fri Sep 26 23:07;00 CST 2008 


spring_security_session_intagration_fiter_applied 
Br 


图 16-9 ”<debug:info/> 标 签 在 页 面 上 输出 的 调试 信息 


grails.debug.productionOverride-anything 
16.4 ”本 章 小 结 


本 章 对 Grails 的 插件 功能 进行 了 简单 的 介绍 ， 包 括 插件 的 安装 以 及 插件 的 组 织 结构 。 
最 后 以 Acegi 插件 和 Debug 插件 为 例 ， 展 示 了 通过 插件 系统 简化 项 目 开 发 和 调试 。 其 中 
Acegi 插件 是 一 个 非常 强大 的 权限 控制 管理 系统 ， 通 过 它 可 以 方便 地 实现 对 用 户 、 角 色 、 
资源 进行 管理 ， 从 而 解决 与 系统 安全 相关 的 问题 。 对比 第 6 章 自己 实现 的 注册 、 登 录 页 面 ， 
使 用 Acegi 的 优势 就 可 以 充分 显现 了 。Grails 目前 已 经 拥有 大 量 的 可 用 插件 ， 感 兴趣 的 读 
者 不 妨 多 花 些 时 间 阅 读 一 下 官方 的 插件 列表 ， 相 信 一 定 能 从 中 选 出 一 些 对 自己 有 帮助 的 
插件 。 


Grails 解密 


学 习 完 第 二 部 分 ， 读 者 应 该 可 以 使 用 Grails 开发 简单 的 Web 应 用 了 ; 学 习 
了 第 三 部 分 ， 读 者 应 该 掌握 了 不 少 Grails 的 高 级 技能 ， 并 且 能 够 进行 调 优等 较 
高 级 的 操作 了 ， 通 过 使 用 插件 ， 还 可 以 更 轻松 地 开发 更 为 复杂 的 功能 。 

越 是 这 种 复杂 的 功能 ， 越 显示 出 了 Grails 的 神奇 。 但 是 ， 在 计算 机 中 ， 并 
不 存在 任何 神奇 的 东西 、 任 何 奇 妙 的 程序 ， 都 是 通过 一 行 一 行 的 代码 实现 的 。 
Grails 的 神奇 ， 源 于 Groovy 的 神奇 。 本 书 的 第 四 部 分 ， 就 打算 从 Groovy 的 高 
级 特性 入 手 ， 结 合 少量 的 Grails 源 程序 ， 解 密 为 什么 Grails 可 以 如 此 的 神奇 。 
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Grails 的 神奇 源 于 Groovy 的 强大 。 本 书 一 开始 就 介绍 过 ，Groovy 是 一 种 动态 脚本 语 
言 ， 本 章 将 对 Groovy 的 动态 特性 进行 曾 述 。 


17.1 动态 方法 调用 与 属性 访问 


17.1.1 动态 方法 调用 
在 Groovy 中 ， 可 以 使 用 字符 串 作为 方法 名 ， 实 现 方法 调用 : 


class Foo { 
def bar() { 
println "foo bar" 
} 
} 


def strMethodName = "bar" 
def foo = new Foo() 
foo."${strMethodName}" () 


从 上 例 的 黑 斜 体 部 分 可 以 看 到 ， 因 为 使 用 了 在 编译 时 无 法 确定 其 内 容 的 字符 串 作 为 方 
法 名 去 调用 方法 ， 所 以 说 此 时 的 方法 调用 是 动态 的 。 
对 于 包含 参数 的 方法 ， 也 可 以 使 用 相似 的 方法 进行 调用 : 


foo."${strMethodName}" (paraml,param?2) 
对 于 多 个 参数 的 情况 ， 可 以 使 用 “* ”运算 符 将 数组 〈List) 展开 : 


def params = [paraml, param2] 
foo."${strMethodName}"( *params ) 


17.1.2 ”动态 属性 访问 


对 于 Groovy 对 象 的 属性 访问 ， 属 性 名 也 可 以 是 在 编译 时 未 知 的 : 


因此 ， 通 过 “[]” 运 算 符 ， 可 以 实现 用 “[]” 运 算 符 访问 Groovy 对 象 的 属性 。 
17.2 invokeMethod 和 getProperty 


在 Groovy 中 , 可 以 通过 重 载 invokeMethod、 setProperty 和 getProperty 方法 , 在 Groovy 
对 象 上 访问 未 定义 过 的 方法 和 属性 。 


输出 内 容 为 : 


这 里 并 没有 在 Foo 类 中 定义 过 hello 和 speak 方法 ， 但 执行 fpohello0 和 foo.speakO 并 
不 会 报错 , 其 奥妙 就 在 于 invokeMethod 方法 .invokeMethod 方法 会 拦截 对 未 知 方法 的 调用 。 
invokeMethod 的 第 一 个 参数 是 被 拦截 的 方法 名 称 ,第 二 个 参数 是 被 拦截 方法 的 参数 (Object[] 
类 型 )。 

通过 invokeMethod 方法 的 支持 ， 可 以 调用 未 定义 的 方法 ， 从 而 写 出 很 有 创意 的 程序 ， 
例如 XML Builder: 


Ll 是 一 个 关键 点 ， 通 过 将 当前 对 象 this 设 定 为 闭 包 对 象 delegate， 从 而 使 得 在 闭 包 中 
可 以 调用 this 的 方法 。L2 在 调用 head 方法 时 ， 实 际 上 在 调用 this 的 head 方法 ， 又 由 于 
XmlBuilder 中 不 存在 head 方法 ，invokeMethod 方法 会 被 再 次 调用 。 相 信 读 者 在 真正 理解 
了 上 面 的 代码 之 后 ， 对 Grails 中 众多 Builder (如 HibernateCriteriaBuilder、JSON Builder、 
XML Builder、Spring Builder 等 ) 的 实现 原理 ， 应 该 已 经 有 了 一 定 的 想法 了 。 

事实 上 invokeMethod 也 可 以 拦截 “已 知 ”方法 (类 中 定义 过 的 方法 )。 但 要 求 Groovy 
类 必须 实现 GroovyInterceptable 接口 : 


不 难 想象 , 在 Groovy 中 , 可 以 比较 轻松 地 通过 imvokeMethod 方法 ， 实现 AOP! 编 程 。 
不 过 AOP 不 是 本 书 的 重点 ， 感 兴趣 的 读者 可 以 阅读 相关 文章 Du0。 
与 invokeMethod 的 功能 类 似 , 重 载 getProperty/setProperty 方法 可 以 访问 未 定义 的 属性 : 


1AOP (Aspect Oriented Programming， 面 向 切面 编程 ) 的 目标 是 通过 预 编译 方式 和 运行 期 动态 代理 实 
现在 不 修改 源 代码 的 情况 下 给 程序 动态 统一 添加 功能 。AOP 实际 是 GoF 设计 模式 的 延续 ， 设 计 模 式 孜 孜 
不 倦 追求 的 是 调用 者 和 被 调用 者 之 间 的 解 耦 ，AOP 可 以 说 也 是 这 种 目标 的 一 种 实现 


methodMissing 和 propertyMissing 方法 ， 与 invokeMethod 和 getProperty/setProperty 方 
法 非常 类 似 ， 它 们 的 含义 是 拦截 因为 方法 或 者 属性 不 存在 而 引发 的 错误 。 对 于 static 的 方 
法 和 属性 ， 可 以 通过 在 Groovy 对 象 的 metaClass 上 使 用 methodMissing 和 propertyMissing 
实现 动态 添加 。 


17.3 MOP 动态 基础 


Groovy 的 Team Leader 一 一 Guillaume Laforge 说 过 , MOP (Meta Object ProtocoD) 是 他 最 
喜欢 的 Groovy 特性 。 

虽然 通过 invokeMethod 可 以 实现 调用 未 知 的 属性 和 方法 ， 但 是 通过 invokeMethod 并 
没有 真正 地 为 Groovy 类 添加 方法 !。 对 于 动态 脚本 语言 而 言 ， 在 运行 时 能 够 动态 地 添加 方 
法 和 属性 ， 是 非常 普遍 的 特性 。 在 Groovy 中 ， 这 可 以 通过 MOP 实现 。 


17.3.1 ”遍历 方法 和 属性 


MOP 是 Groovy 中 的 一 个 比较 重要 的 概念 ， 它 是 实现 Groovy 动态 特性 的 基础 。 每 个 
Groovy 类 都 包含 一 个 metaClass 属性 ， 通 过 metaClass 可 以 实现 遍历 方法 和 属性 ， 也 可 以 
实现 动态 添加 方法 和 属性 。 空 谈 概念 ， 星 涩 又 无 趣 ， 通 过 下 面 的 简单 例 程 ， 对 metaClass 
能 产生 一 个 初步 的 认识 : 


程序 的 输出 为 : 


! 严格 来 说 ， 不 仅 可 以 在 Groovy 类 上 使 用 MOP， 普 通 的 Java 类 ， 甚 至 接口 ， 也 都 可 以 使 用 。 


从 上 面 的 代码 可 以 看 到 ， 通 过 metaClass 可 以 轻松 地 对 类 的 方法 和 属性 进行 遍历 。 通 
过 respondsTo 方法 和 hasProperty 方法 可 以 判断 当前 对 象 是 否 包含 某 一 方法 或 属性 。 


17.3.2 ”动态 添加 方法 


metaClass 可 以 为 对 象 动态 地 添加 方法 : 


从 上 面 的 代码 可 以 看 出 ， 在 Groovy 中 可 以 直接 向 类 的 metaClass 添加 方法 ， 具 体 方 
法 为 : 

类 名 .metaClass. 方 法 名 = 闭 包 

或 者 : 

类 名 .metaClass. 方 法 名 << 闭 包 

“=” 可 以 覆盖 已 有 的 方法 ,“<<” 表 示 加 入 新 的 方法 。 如 果 新 加 入 的 方法 名 称 和 参数 
都 与 旧 的 完全 一 致 ， 使 用 “=” 会 覆盖 旧 的 方法 ， 而 使 用 “<<” 时 会 报错 。 

MOP 实现 添加 方法 ， 实 现 得 非常 彻底 ， 上 面 的 方法 名 称 也 可 以 是 动态 的 与 第 17.1 
节 相 似 ， 使 用 字符 串 )， 例 如 : 


如 果 动 态 添加 的 方法 包含 参数 ， 则 需要 传 入 带 参数 的 闭 包 : 


如 果 闭 包 中 不 定义 参数 ， 则 与 上 例 相同 ， 可 以 传 入 任意 类 型 的 参数 。 如 果 指 定 严格 类 
型 的 参数 ， 则 调 入 时 必须 传 入 指定 的 类 型 ， 例 如 : 


如 果 和 希望 添加 强制 无 参数 的 方法 ， 则 闭 包 也 需要 定义 为 无 参数 的 闭 包 : 


通过 MOP 添加 的 方法 ， 也 支持 重 载 (over load) 特性 : 


此 时 的 输出 为 : 


通过 MOP 机 制 , 还 可 以 动态 添加 构造 函数 。 只 需要 指定 metaClass 的 constructor 属性 。 
可 以 使 用 “=” 或 者 使 用 “<<” 运 算 符 传 入 一 个 闭 包 : 


不 过 使 用 MOP 添加 构造 函数 要 格外 小 心 ， 因 为 有 可 能 发 生 无 穷 递 归 ， 从 而 发 生 堆 栈 
溢出 的 错误 ， 例 如 : 


二 


使 用 MOP 同样 支持 动态 添加 静态 方法 ， 其 方法 与 加 入 普通 方法 非常 相似 ， 具 体 为 : 
类 名 .metaClass. 'static'. 方 法 名 = 闭 包 

或 者 : 

类 名 .metaClass. 'statie'. 方 法 名 << 闭 包 

例如 : 


显然 ,通过 MOP 机 制 ,可 以 轻松 地 实现 动态 添加 方法 。 所 以 也 不 难 想象 ,为 什么 Domain 
包 中 的 类 会 自动 地 拥有 持久 化 的 方法 。Groovy 在 语言 级 别 有 了 MOP 这 样 的 基础 功能 ， 那 
么 用 Groovy 实现 什么 样 的 框架 , 就 要 看 使 用 者 的 想象 力 了 。 使 用 MOP, 可 以 向 别 的 类 “ 借 ” 
方法 。Groovy 中 可 以 用 & 运 算 符 将 方法 转换 为 闭 包 ， 因 此 ,“ 借 ”方法 不 难 实现 ; 


17.3.3 ”动态 添加 属性 


使 用 MOP 除了 可 以 动态 添加 方法 外 , 还 可 以 添加 属性 , 否则 Domain 类 就 不 会 被 自动 
添加 id 和 version 了 。 

通过 MOP 添加 属性 是 非常 简单 的 ， 具 体 方法 为 : 

类 名 .metaClass. 属 性 名 = 属性 值 


这 里 的 属性 值 比较 重要 ， 因 为 属性 值 的 类 型 将 决定 属性 的 类 型 。 给 对 象 实例 指定 属性 
值 时 ， 如 果 使 用 了 与 属性 值 类 型 不 符 的 变量 ， 则 会 报错 : 


除了 上 面 的 做 法 外 ， 还 可 以 通过 添加 方法 实现 添加 属性 。 本 质 上 ，Java 和 Groovy 对 
象 的 属性 都 是 由 setter 和 getter 两 个 方法 实现 的 。 因 此 ， 通 过 添加 方法 ， 也 可 以 实现 添加 属 
性 ， 例 如 : 


然而 ， 由 于 仅仅 是 添加 方法 ， 并 没有 在 对 象 中 添加 成 员 变 量 ， 因 此 想 添加 可 读 可 写 属 
性 并 不 容易 ， 还 需要 设计 如 何 存储 对 象 数据 : 


第 二 种 方法 虽然 也 能 实现 添加 属性 , 但 显然 不 如 第 一 种 直观 , 所 以 一 般 也 不 推荐 使 用 。 


17.3.4 ”使 用 方法 对 象 


熟悉 Java 反射 的 读者 ， 一 定 对 Method 对 象 不 会 陌生 ， 一 个 Method 实例 就 对 应 为 某 
个 对 象 的 成 员 方法 。 类 似 地 ，Groovy 的 MOP 中 也 包含 类 似 的 功能 ， 不 过 更 简单 ， 也 更 友 
好 ， 例 如 : 


二 = 


通过 metaClass 的 getMetaMethod() 方 法 可 以 获取 metaMethod 对 象 ， 调 用 metaMethod 
对 象 的 invoke 方法 ， 就 可 以 执行 相应 的 方法 了 。 


17.3.5 为 某 一 特定 的 实例 添加 方法 


前 面 介 绍 的 MOP 技术 都 是 “类 ”级 别 的 。 修 改 某 一 类 的 metaClass， 则 之 后 用 该 类 创 
建 的 实例 都 会 有 所 改变 。 事 实 上 ，MOP 支持 比 类 更 细 粒 度 的 使 用 级 别 ， 可 以 单独 在 某 一 个 
对 象 上 使 用 MOP。 

对 于 Groovy 对 象 , 可 以 直接 创建 ExpandoMetaClass 实例 ,并 使 用 它 蔡 换 Groovy 对 象 
的 metaClass: 


这 里 要 注意 一 点 ， 不 能 将 程序 写成 如 下 的 形式 : 


原因 是 一 旦 蔡 换 了 某 一 对 象 的 metaClass， 则 必须 在 其 metaClass(ExpandoMetaClass) 


的 initialize0 方 法 执行 完毕 之 后 ,才能 调用 它 的 其 他 方法 。 以 上 面 的 代码 为 例 , 第 一 行 蔡 换 
了 gl 的 metaClass, 则 第 二 行 代码 会 报错 , 原因 是 gl 的 metaClass 在 没有 执行 过 initialize() 
方法 的 前 提 下 执行 了 gl.metaClass.test = { ... }， 相 当 于 调用 了 gl.getMetaClass() 方 法 。 也 
就 是 说 ， 它 在 没有 调用 过 initialize() 方 法 的 情况 下 ， 调 用 了 getMetaClass0 方 法 ， 因 而 会 
报错 。 

关于 ExpandoMetaClass， 还 需要 再 补充 一 点 : 执行 了 ExpandoMetaClass 的 initialize() 
方法 之 后 ， 就 不 能 再 向 ExpandoMetaClass 添加 方法 了 。 通常 向 某 一 Groovy 对 象 添加 方法 ， 
都 会 写成 这 样 的 形式 : 


MOP 中 同样 也 可 以 对 单个 的 Java 对 象 实例 添加 方法 ， 但 由 于 普通 的 Java 类 没有 实现 
GroovyObject 接口 ， 所 以 实例 中 也 不 存在 metaClass 属性 。 因 而 向 Java 对 象 添加 方法 的 方 
法 稍微 有 所 不 同 ， 需 要 用 groovy.util.Proxy 对 Java 对 象 进行 包装 : 


输出 : 
向 aava 对 象 汪 加 动态 方法 
对 单个 的 Java 对 象 实例 添加 方法 ， 是 不 是 也 很 简单 ? 


17.4 本 章 小 结 


本 章 对 Groovy 的 部 分 高 级 特性 进行 了 介绍 , 并 重点 阑 述 了 Groovy 的 MOP 机制 .Grails 
的 神奇 很 大 程度 上 源 于 Groovy 强大 的 MOP 机 制 。 只 有 了 解 了 Groovy 的 动态 特性 ， 才 能 
深入 学 习 Grails 的 原理 和 阅读 Grails 的 源码 。 对 这 部 分 内 容 感 兴趣 的 读者 ， 不 妨 多 花 些 时 
间 阅 读 一 下 Groovy 的 官方 网 站 。 如 果 能 够 打下 扎实 的 Groovy 基础 ， 阅 读 Grails 源码 会 事 
半 功 倍 。 


Grails 插件 开发 
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第 16 章 介绍 了 Grails 插件 的 安装 和 使 用 , 本 章 将 讨论 Grails 插件 开发 相关 的 技术 。 开 
发 Grails 的 插件 ， 需 要 掌握 Groovy 的 MOP 编程 技术 。 对 于 还 没有 掌握 MOP 技术 的 读者 
应 先 阅读 第 17 章 高 级 Groovy 特性 ， 补 充 一 下 这 方面 的 知识 。 

本 质 上 , Grails 各 个 模块 的 大 部 分 功能 都 是 通过 系统 插件 的 形式 组 织 的 : URL mappings、 
codecs、controllers、core、dataSource、domainClasses、filters、hibernate、118n、logging、 
scaffolding、services、servlets、Web flow 等 各 个 模块 ， 是 分 别 使 用 了 不 同 的 插件 来 实现 的 。 
与 其 他 插件 唯一 不 同 的 是 ， 它 们 是 以 系统 插件 的 形式 存在 的 ， 无 需 单独 安装 。 


18.1 创建 与 发 布 插件 


Grails 中 提供 了 简便 的 插件 创建 命令 ，create-plugin': 
grails create-plugin MyPlugin 


此 时 ，Grails 会 在 项 目的 根 目录 创建 一 个 名 为 MyPlugin 的 文件 夹 ， 其 内 部 的 文件 组 织 
结构 与 典型 的 Grails 项 目 是 非常 相似 的 : 


GDepot\MyPlugin\src 
GDepot\MyPlugin\src\java 
GDepot\MyPlugin\src\groovy 
GDepot\MyPlugin\grails-app 
GDepot\MyPlugin\grails-app\controllers 
GDepot\MyPlugin\grails-app\services 
GDepot\MyPlugin\grails-app\domain 
GDepot\MyPlugin\grails-app\taglib 
GDepot\MyPlugin\grails-app\utils 
GDepot\MyPlugin\grails-app\views 
GDepot\MyPlugin\grails-app\views\layouts 
GDepot\MyPlugin\grails-app\il8n 
GDepot\MyPlugin\grails-app\conf 
GDepot\MyPlugin\test 


1 create-plugin 命令 不 需要 在 某 一 Grails 工程 内 运行 ， 因 而 它 创 建 的 插件 不 与 任何 具体 的 Grails 工程 
相关 。 可 以 将 新 创建 的 插件 理解 为 是 一 个 全 新 的 工程 ， 即 插件 工程 。 


插件 工程 与 普通 Grails 工程 相似 ， 运 行 插件 也 和 运行 普通 Grails 工程 完全 一 致 。 需 要 
进入 工程 文件 夹 (MyPlugin) 并 运行 run-app 命令 : 


同 理 ， 插 件 工程 也 可 以 进行 自动 化 测试 : 


插件 文件 夹 的 根 目录 中 有 一 个 非常 重要 的 Grails 插件 描述 文件 。 按 照 约定 优 于 配置 的 
原则 ， 其 文件 名 为 “插件 名 +GrailsPlugin.groovy” 即 MyPluginGrailsPlugin.groovy。 通 过 这 
个 类 ， 可 以 配置 插件 的 描述 信息 ， 包 括 版 本 、 作 者 信息 等 : 


其 中 ， 
(1) title 一 一 插件 的 标题 ; 

(2) author 一 一 插件 作者 的 姓名 ; 

(3) authorEmail 一 一 插件 作者 的 E-mail; 


多 行 字符 串 ， 用 于 描述 插件 的 用 途 ; 


(4) descriptiom 


(5) documentation 一 一 插件 文档 的 URL。 
当 某 一 插件 开发 完毕 后 ， 需 要 使 用 package-plugin 命令 对 插件 进行 打包 : 


Grails 会 创建 名 为 “grails- 插 件 名 称 -版 本 号 .zip” 的 压缩 包 。 但 压缩 包 中 不 会 包含 插件 
工程 的 全 部 内 容 ， 以 下 部 分 会 被 排除 在 外 : 

(1) grails-app/conf/DataSource.groovy; 

(2) grails-app/conf/UrIMappings.groovy; 

(3) web-app/WEB-INF/*.*。 

这 里 需要 说 明 的 是 ， 如 果 需 要 在 插件 内 定义 Url 映射 ， 则 需要 给 配置 文件 起 一 个 全 新 
的 名 称 ， 例 如 MyPluginUrlMappings.groovy。 重 新 命名 的 文件 不 会 被 排除 在 外 。 

如 果 和 希望 将 自己 开发 的 插件 提交 给 Grails 官方 并 向 全 世界 的 Grails 开发 人 员 共 享 ， 可 
以 通过 http://www.g2one.com 联系 G2One team， 他 们 审核 通过 并 分 配 相应 的 权限 。 此 后 ， 
使 用 Grails 命令 release-plugin 就 可 以 将 插件 的 更 新 同步 发 布 到 Grails 官方 的 源 代码 管理 容 
器 中 。 相 应 地 ， 执 行 list-plugin 命令 时 看 到 的 返回 结果 也 会 包含 更 新 。 


18.2 ”插件 能 做 什么 


“插件 能 做 什么 ? ”似乎 任何 Grails 插件 开发 相关 的 内 容 都 应 该 从 这 个 问题 开始 入 手 。 
从 上 一 节 讨 论 的 Grails 的 插件 组 织 结构 可 以 了 解 到 ，Grails 的 插件 工程 实际 上 和 一 个 普通 
的 Grails 工程 非常 相似 。 因 而 ， 在 插件 项 目 中 ， 可 以 和 普通 的 Grails 项 目 一 样 ， 创 建 
Controller、GSP 页 面 、Domain 类 、Service、 自 定义 Taglib、 自 定义 编码 (Codec)、 自 定 
义 控制 台 命令 等 。 

除了 这 些 基本 的 功能 外 ， 还 可 以 通过 插件 在 其 他 几 个 方面 进行 开发 。 回 忆 一 下 
MyPluginGrailsPlugin 类 的 内 容 : 


除了 编写 用 于 描述 插件 信息 的 属性 外 ， 还 有 6 个 闭 包 ， 分 别 对 应 若干 功能 ， 分 别 是 ; 
添加 Spring 配置 信息 、 与 Spring ApplicationContext 交互 、 参 与 生成 web.xml、 添 加 动态 方 
法 、 捕 获 程 序 和 配置 信息 的 变更 。 正 是 这 些 看 似 平凡 的 功能 ， 构 成 了 实现 Grails 的 基础 。 
下 面 对 这 几 点 逐一 加 以 讨论 。 

在 讨论 插件 的 各 个 功能 点 之 前 ， 不 妨 先 了 解 一 下 插件 类 的 属性 ， 每 个 插件 类 隐 式 地 包 
含 了 application 属性 。application 是 GrailsApplication 接口 的 实例 。GrailsApplication 包含 
了 很 多 非常 实用 的 方法 。 

(1 ) *Classes 一 一 动态 方法 , 获取 系统 中 特定 类 型 的 类 , 如 application.controllerClasses、 
application.domainClasses 。 

(2) get*Class 一 一 动态 方法 ， 通 过 类 名 获取 某 一 符合 特定 类 型 的 类 ， 如 application.get- 
ControllerClass(GoodsController) 。 

(3) is*Class 一 一 动态 方法 ， 判 断 某 一 类 是 否 为 某 一 类 型 ， 如 : application.isController- 
Class(GoodsControllerclass) 。 

(4) add*Class 一 一 动态 方法 ， 将 某 一 类 加 入 到 系统 中 ， 如 : application.addController- 
Class(GoodsController.class)。 

这 里 还 需要 注意 一 点 ，*Classes 和 is*Class 返回 的 是 GrailsClass 接口 的 实例 (或 者 
GrailsClass 接口 的 数组 )， 例 如 : 


GrailsClass 也 提供 了 大 量 实 用 的 方法 。 

(1) getPropertyValue 一 一 读 取 属 性 的 初始 值 。 

(2) hasProperty 一 一 判断 是 否 包 含 某 一 属性 。 

(3) newInstance 一 一 创建 当前 类 的 新 实例 。 

(4) getName 一 一 返回 类 的 逻辑 名 称 (不 包括 包 名 以 及 约定 部 分 的 名 称 , 例如 ，Groods- 
Controller 将 返回 Goods)。 

(5) getShortName 一 一 返回 不 包含 前 缀 的 类 名 。 

(6) getFullName 一 一 返回 完整 的 类 名 。 

(7) getNaturalName 一 一 返回 更 友好 的 名 称 ( 例 如 ，'lastName' 会 变 成 Last Name')。 

(8) getPackageName 一 一 返回 包 名 。 


18.2.1 添加 Spring 配置 信息 
doWithSpring 闭 包 用 于 向 Spring 添加 配置 信息 。 以 Grails 自 带 的 Hibernate 插件 为 例 ， 


在 启动 时 需要 先 向 Spring 容器 添加 更 多 的 bean， 其 中 向 Spring 容器 中 添加 bean 的 方法 可 
以 参考 第 12.2 节 介 绍 的 Spring DSL: 


上 面 的 代码 部 分 引 自 Grails Hibernate 插件 的 源 程序 ， 使 用 的 Spring DSL 在 Spring 容 
器 中 定义 了 Domain 类 的 Validator、SessionFactory、transactionManager 等 。 


类 似 地 ，Acegi 插件 也 在 doWithSpring 闭 包 中 添加 了 大 量 的 Spring 配置 信息 : 


通过 上 面 两 个 例子 ， 可 以 明确 doWithSpring 闭 包 的 用 途 : 在 doWithSpring 闭 包 中 编写 
Spring 的 DSL， 从 而 使 插件 能 够 参与 配置 Spring 容器 中 的 bean。 


18.2.2 与 Spring 容器 交互 


doWithApplicationContext 闭 包 也 用 于 编写 初始 化 Spring 的 代码 。 与 doWithSpring 不 同 
的 是 ，doWithApplicationContext 闭 包 是 在 Spring 容器 初始 化 完成 之 后 被 调用 的 ， 同时， 该 
闭 包 中 可 以 访问 Spring 容器 的 ApplicationContext。 通 过 ApplicationContext 对 象 ， 可 以 容 
易 地 访问 Spring 容器 中 的 Bean。 以 Grails 中 用 于 国际 化 支持 的 I18nGrailsPlugin 插件 为 例 ， 
它 需 要 在 完成 Spring 容器 的 初始 化 后 ， 对 messageSource.resourceLoader 进行 配置 。 


18.2.3 ”修改 web.xml 


Grails 的 准则 是 约定 优 于 配置 ， 因 此 默认 情况 下 不 允许 修改 web.xml 文件 。 但 是 理想 
总 归 是 理想 ，web.xml 在 JSP\Servlet 技术 中 有 着 非常 重要 的 地 位 ，Servlet、Filter、Listener 


等 元 素 ， 都 需要 通过 web.xml 进行 配置 。 因 而 ， 在 实际 项 目 中 很 有 可 能 需要 修改 该 文件 。 
考虑 到 这 一 问题 ，Grails 允许 通过 插件 对 web.xml 进行 配置 ， 可 以 根据 需要 ， 在 插件 的 
doWithWebDescriptor 闭 包 中 编写 Groovy 针对 XML 的 DSL。 其 中 ， 闭 包 的 参数 是 通过 
Groovy 的 XmlSlurper 类 解析 XML 文件 时 返回 的 GPathResult 对 象 。 

以 Grails 的 系统 插件 ControllersPlugin 为 例 : 


ControllersPlugin 通过 doWithWebDescriptor， 添 加 了 servlet 映射 。 
Acegi 插件 同样 也 修改 了 web.xml 的 内 容 : 


如 果 需 要 深入 了 解 GPathResult 对 象 的 使 用 ， 可 进一步 参考 Groovy 的 官方 网 站 : 
http://groovy.codehaus.org/Reading+XML+using+Groovy%27s+XmlSlurper。 

在 Grails 的 插件 列表 中 ， 还 有 专门 用 于 修改 web.xml 的 插件 ， 即 WebXML。 使 用 该 插 
件 可 以 更 容易 定 置 web.xml 的 内 容 。 若 要 了 解 更 多 详情 ,可 进一步 参考 http://www.grails.org/ 
WebXML+Plugin。 


18.2.4 添加 动态 方法 


doWithDynamicMethod 闭 包 可 以 实现 添加 动态 方法 。 闭 包 的 参数 是 Spring 的 
ApplicationContext, 因此 添加 的 动态 方法 可 以 使 用 Spring 容器 中 的 资源 ,Grails 的 Hibemate 
插件 ， 通 过 添加 动态 方法 ， 使 得 Domain 类 都 包含 了 持久 化 相关 的 方法 。 而 添加 动态 方法 
的 原理 在 上 一 章 已 经 讨论 过 了 ， 是 通过 Groory 语言 的 MOP 机 制 实现 的 ， 例 如 : 


此 时 , 所 有 的 Controller 类 中 都 可 以 调用 myNewMethod 方法 。 实 际 的 Grails 插件 也 大 
量 使 用 了 doWithDynamicMethod 闭 包 。Hibernate 插件 的 代码 稍 显 复杂 , 不 感 兴趣 的 读者 不 
妨 跳 过 ， 这 里 仅 部 分 摘录 其 内 容 如 下 : 


Hibernate 插件 添加 动态 方法 的 过 程 非常 巧妙 。 为 了 避免 启动 时 间 过 长 ,设计 了 延 时 加 
载 的 机 制 。 只 有 当 Domain 类 发 生 missing method 事件 时 ， 才 调用 initDomainClass， 以 实 
现 向 Domain 类 添加 动态 方法 。 


18.2.5 ”捕获 变更 


用 Grails 开发 Web 应 用 的 时 候 ， 通常 修改 程序 时 不 需要 重新 启动 应 用 ， 这 使 得 开发 体 
验 变 得 更 加 友好 。 然 而 ， 计 算 机 中 不 存在 神奇 ， 一 切 都 是 程序 控制 的 。 这 后 面 又 是 通过 怎 
样 的 机 制 ， 实 现 修改 程序 而 无 需 重启 服务 器 的 呢 ? 

Grails 的 插件 类 中 提供 两 个 闭 包 onChange 和 onConfigChange, 它们 分 别 用 于 捕获 源 程 
序 的 变更 和 捕获 配置 文件 的 变更 ， 从 而 可 以 实现 在 变更 发 生 时 ， 重 新 读 取 相 应 的 程序 或 
资源 。 

onChange 和 onConfigChange 闭 包 的 参数 是 event 对 象 ， 该 对 象 包含 以 下 几 个 实用 的 
属性 。 

(1) eventsource 一 一 事件 来 源 ， 可 能 是 类 文件 ， 也 可 能 是 Spring 资源 文件 ; 

(2) eventctx 一 一 Spring 的 ApplicationContext 对 象 ; 

(3) eventplugin 一 一 管理 资源 的 插件 对 象 实例 ， 通 常 是 this; 

(4) eventapplication 一 一 GrailsApplication 实例 。 

以 系统 插件 ServicePlugin 为 例 ， 该 插件 需要 监视 Service 类 的 变化 ， 当 Service 类 发 生 
改变 时 ， 将 变化 的 类 重新 装 入 系统 ， 并 更 新 Spring 容器 : 


人 一 


其 中 , watchedResources 属性 用 于 定义 被 监视 的 资源 。watchedResources 属性 既 可 以 是 
String 类 型 ， 也 可 以 是 List 类 型 。 
Hibemate 插件 的 onChange 事件 处 理 得 更 彻底 ， 直 接 重 启 了 应 用 : 


除了 程序 、 资 源 的 变更 外 ，Grails 也 为 配置 文件 的 变更 设置 了 相应 的 处 理事 件 。 
onConfigChange 闭 包 用 于 捕获 配置 文件 发 生 的 变化 。 以 系统 插件 LoggingGrailsPlugin 为 例 : 


关于 捕获 变更 ， 还 存在 一 个 需求 ,不 同 的 插件 有 可 能 存在 依赖 。 某 一 插件 捕获 了 变更 ， 
需要 通知 其 他 插件 更 新 ， 或 者 某 一 插件 需要 知道 是 否 其 他 插件 发 生 了 更 新 。Grails 的 插件 
系统 对 这 两 种 情况 都 提供 了 支持 。 

observe 属性 用 于 定义 “观察 ”其 他 插件 的 变化 。 如 果 所 观察 的 插件 发 生 了 变化 ， 则 
也 需要 触发 变更 事件 。 例 如 ， 观 察 Hibernate 插件 是 否 发 生 了 变化 : 


influences 属性 用 于 通知 其 他 插件 处 理 变 化 。 例 如 ， 如 果 当 前 插件 的 变化 需要 通知 
Controller 插件 ， 则 应 编写 如 下 代码 : 


18.3 插件 的 依赖 关系 


插件 与 插件 之 间 是 存在 依赖 关系 的 , 例如 Hibernate 插件 依赖 于 dataSource 插件 ,也 一 
定 是 依赖 于 Domain 插件 的 。 如 果 dataSource 插件 和 Domain 插件 没有 启动 ，Hibernate 插 
件 显然 也 是 无 法 启动 的 。 

使 用 dependsOn 属性 , 可 以 配置 插件 间 的 依赖 关系 。 dependsOn 属性 是 Map 类 型 , Map 
的 键 是 插件 名 称 ， 值 是 版 本 号 : 


version 的 写法 还 可 以 更 加 智能 ， 例 如 : 


其 中 “*” 表 示 任 意 的 版 本 ， 即 “* > 1.0” 表 示 大 于 1.0 版 的 任意 版 本 ;“1.0 >*” 表 示 
小 于 1.0 的 任意 版 本 。 此 外 ,当前 的 表达 式 在 判断 时 会 自动 过 滤 掉 BETA、ALPHA 等 后 缀 ， 
因而 “1.0> 1.1” 可 以 匹配 以 下 的 所 有 版 本 : 1.1、 1.0、1.0.1、 1.0.3-SNAPSHOT、 1.1-BETA2。 

dependsOn 属性 定义 了 比较 严格 的 依赖 关系 ， 除 了 dependsOn 外 ， 还 有 一 种 方式 可 以 
定义 相对 较 弱 的 依赖 关系 ， 即 loadAfter 属性 ， 它 用 于 仅 指定 载 入 的 顺序 。 例 如 ，Hibernate 
插件 虽然 不 严格 依赖 于 Controller 插件 ,但 需要 在 启动 Controller 插件 之 后 启动 ， 因 此 它 使 
用 了 loadAfter 属性 : 


18.4 在 安装 或 升级 时 执行 附加 操作 


每 个 Grails 项 目 和 插件 项 目 中 , 都 包含 名 为 scripts 的 文件 夹 , 其 中 的 groovy 程序 是 自 
定义 的 控制 台 命 令 。 

Grails 的 众多 控制 台 命 令 本 质 上 是 在 运行 Apache Ant 的 Task。 使 用 Groovy 的 GAnt 
技术 ， 可 以 使 用 Groovy 程序 编写 Ant 的 buildxmln304。 

插件 项 目的 scripts 文件 夹 中 默认 包含 了 两 个 命令 文件 ，_Intall.groovy 和 _Upgrade. 
groovy， 它 们 分 别 用 于 在 安装 和 升级 插件 时 ， 执 行 附加 操作 。 


18.5 ”本 章 小 结 


本 章 介 绍 了 Grails 的 插件 开发 技术 。 通 过 学 习 本 章 内 容 ,可 以 开发 用 于 Grails 的 插件 ， 
从 而 实现 对 Grails 的 自由 扩展 。Grails 的 插件 技术 也 是 Grails 的 基础 ， 整 个 Grails 框架 都 
需要 运行 在 这 一 插件 平台 之 上 。 理 解 Grails 的 插件 原理 ， 是 学 习 Grails 原理 必要 的 前 提 。 
下 一 章 将 要 讨论 Grails 源 程序 ， 本 章 的 系统 插件 部 分 是 重要 的 突破 口 。 
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本 章 不 打算 对 Grails 的 源码 进行 全 面 的 分 析 ， 只 是 对 其 中 几 个 功能 点 进行 简单 分 析 : 

(1) HibernateCriteriaBuilder 一 直 被 认为 是 很 神奇 的 东西 ， 本 章 将 分 析 其 实现 原理 ， 解 
密 神奇 的 本 质 ; 

(2) 第 11 章 曾 经 提 到 过 ， 使 用 Grails 内 置 方法 构造 的 数据 库 查询 ， 都 没有 开启 
Query-Cache， 本 章 将 尝试 修改 其 源码 ， 为 查询 添加 能 够 配置 Query-Cache 的 选项 。 


19.1 准备 工作 


19.1.1 下 载 源码 

首先 从 Grails 官方 网 站 (http://www.grails.org/Download) 下 载 Grails1.0.4 的 源 代码 ( 选 
择 Source Zip 或 者 Source Tar/GZ)， 然 后 解压 至 本 地 硬盘 。 事 实 上 ， 配 置 Grails 环境 变量 
时 ， 就 可 以 选用 Source 包 ， 因 为 Source 包 中 含有 Binary 包 的 全 部 内 容 。 
19.1.2 ”编译 Grails 源码 


可 以 看 到 源码 中 包含 了 如 图 19-1 所 示 的 内 容 。 


了 


TE Bb bb 


buildxml 
档 


INSTALL LICENSE 


19-1 ”Grails 源码 目录 


其 中 的 ant 文件 夹 和 build.xml 会 让 用 户 眼 前 一 亮 。 可 以 使 用 ant 对 Grails 进行 编译 和 
打包 。 在 控制 台中 输入 : 


该 命令 将 运行 构建 Grails 的 ant 脚本 。 但 会 有 一 个 问题 ， 该 脚本 的 默认 task 需要 花费 
非常 长 的 时 间 用 于 自动 测试 ， 而 且 ， 如 果 使 用 Java6 还 可 能 出 现 测试 失败 的 情况 : 


阅读 ant 脚本 ant\build\unit-test.xml 可 知 ， 如 果 在 配置 文件 中 定义 配置 项 为 skipTests= 
true， 则 构建 时 不 会 再 执行 自动 测试 。 因 此 可 以 修改 build.properties 文件 ， 加 入 skipTests= 


true'， 并 重新 运行 ant， 可 见 如 下 结果 : 


这 一 次 可 以 看 到 提示 构建 成 功 的 字样 。 但 由 于 在 构建 过 程 中 重新 生成 了 文档 ， 重 新 进 
行 了 打包 (binary 包 、source 包 等 )， 总 时 间 还 是 显得 过 长 。 事 实 上 ， 只 需要 重新 编译 和 生 
成 jar 包 就 可 以 了 。 再 次 阅读 buildxml ，default 任务 需要 依赖 于 clean 、build 、 
test-with-coverage、jar、javadoc、package 任务 。 直 接 运行 jar 任务 效果 如 何 ? 可 进行 如 下 


试验 ， 直 接 在 控制 台 输入 相关 命令 并 分 析 结 果 : 


1 按 道理 讲 ， 关 闭 自 动 测试 存在 风险 ， 但 TEST grails.build.eclipse.EclipseClasspathTests FAILED 不 是 
真正 测试 出 了 bug， 这 个 问题 只 存在 于 使 用 Java 6 构建 的 系统 。 


可 以 看 出 ， 构 建 脚本 同样 执行 了 编译 操作 ， 然 后 生成 了 jar 包 ， 而 且 速 度 非常 快 ， 只 
花 了 几 秒 钟 。 


如 果 环 境 变量 中 配置 GRAILS_HOME 指向 的 文件 夹 , 就 是 当前 这 个 运行 ant 脚本 的 文 
件 夹 ， 则 构建 后 无 需 配 置 任何 内 容 ， 否 则 ， 需 要 用 新 创建 的 jar 包 蔡 
换 %GRAILS_HOME%\dist 文件 夹 下 对 应 的 jar 包 。 


19.2 ”HibernateCriteriaBuilder 的 原理 


回顾 第 5 章 ， 相 信 读 者 一 定 对 HibernateCriteriaBuilder 的 威力 留 下 了 深刻 的 印象 。 它 
是 如 此 的 神奇 ， 使 得 数据 库 的 查询 变 得 如 此 简单 。 本 节 就 对 HibernateCriteriaBuilder 的 实 
现 进行 解密 。 

通过 阅读 Hibernate 插件 的 源 程序 (src\groovy\org.codehaus\groovy\grails\ 
plugins\orm\hibernate\HibernatePlugin.groovy) 可 以 找到 为 Domain 类 添加 createCriteria 方法 
的 源码 : 


可 以 看 出 ， 调 用 Domain 类 的 createCriteria 方法 ， 实 际 上 是 创建 并 返回 了 Hibermate- 
CriteriaBuilder 对 象 。 通过 源码 还 可 以 进一步 确定 ，HibernateCriteriaBuilder 是 一 个 Java 类 ， 
其 位 于 src\persistence\grails\orm\HibernateCriteriaBuilderjava。 


已 经 有 些 奇怪 了 ，17 章 介绍 的 高 级 Groovy 特性 ， 可 以 通过 重 载 mvokeMethod 方法 实 
现 DSL 的 开发 。 既 然 Groovy 可 以 很 容易 地 实现 DSL,， 那 么 为 什么 HibernateCriteriaBuilder 
是 一 个 Java 类 呢 ? 

道理 很 简单 , Java 在 执行 性 能 上 比 Groovy 有 优势 .为 了 提高 Grails 的 性 能 , 整个 Grails 
框架 大 概 有 70% 的 源 代码 是 使 用 Java 开发 的 。 现 在 的 问题 是 ,如 何 使 用 Java 实现 DSL 呢 ? 

事实 上 ，Java 和 Groovy 是 不 分 家 的 。 当 Java 类 实现 了 GroovyObject 接口 后 ， 就 拥有 
了 一 些 Groovy 的 特性 了 ! (如 invokeMethod ) 。HibernateCriteriaBuilder 派生 于 
GroovyObjectSupport 类 ， 而 GroovyObjectSupport 类 实现 了 GroovyObject 接口 : 


GroovyObjectSupport 类 包含 了 如 下 的 方法 : 


有 了 invokeMethod 方法 , 现在 若 想 使 用 Java 实现 DSL, 就 变 得 和 Groovy 一 样 容易 了 。 
其 核心 思想 是 ， 在 对 象 内 部 构造 Hibernate 的 Criteria 对 象 ， 然 后 通过 执行 闭 包 向 Criteria 
对 象 中 添加 查询 条 件 。 


! 严格 地 说 ,是 Java 类 实现 了 GroovyObject 接口 后 ,如 果 在 Groovy 中 调用 , 才 具 有 Groovy 的 特性 。 


从 上 面 摘录 的 代码 中 ， 可 以 看 到 HibernateCriteriaBuilder 支持 分 页 查询 。 但 不 知道 为 
什么 没有 在 文档 中 公开 。 

有 两 个 方法 比较 重要 ， 分别 是 : invokeClosureNode0 方 法 ， 用 于 调用 闭 包 ; 
GrailsHibernateUtil.populateArgumentsForCriteria0) 方 法 ， 用 于 将 分 页 Map 的 内 容 转 换 为 


Criteria 中 的 查询 逻辑 。 


invokeClosureNode 方法 用 于 调用 闭 包 ， 注 意 “callable.setDelegate(this); ”是 实现 这 
一 DSL 的 关键 。 这 一 行 的 代码 使 得 闭 包 中 的 程序 可 以 调用 HibernateCriteriaBuilder 的 成 员 
方法 。 例 如 ， 查 询 时 使 用 的 eq、ge、le、like 等 方法 ， 都 是 HibernateCriteriaBuilder 的 成 员 
方法 ， 可 以 直接 在 闭 包 中 调用 。 


关于 GrailsHibernateUtilpopulateArgumentsForCriteria() 方 法 的 实现 细节 ， 参 见 下 一 节 。 

之 所 以 选择 HibernateCriteriaBuilder， 不 仅仅 是 因为 它 的 神奇 和 有 趣 。Grails 提供 了 大 
量 的 DSL (Builder)， 而 这 些 DSL 的 实现 原理 基本 上 是 一 致 的 。 理 解 了 HibernateCriteria- 
Builder， 再 去 学 习 诸如 Domain 的 mapping、Spring Integration、Web Flow 等 的 原理 ， 都 会 
变 得 比较 轻松 。 


19.3 开启 Hibernate Query Cache 


Hibernate Query Cache 是 用 查询 数据 库 SQL 语句 作为 cache 的 键 ， 缓 存 查询 结果 的 主 
键 集合 。 使 用 Query Cache 技术 ， 可 以 实现 对 相同 的 SQL 不 重复 地 查询 数据 库 ， 从 而 减 小 
开销 并 提高 性 能 。 

Grails 封装 的 查询 方法 都 无 法 开启 Query Cache， 因 此 目前 只 能 通过 Hibermate- 
CriteriaBuilder 使 用 Query Cache。Grails 社区 已 经 认识 到 了 这 一 点 ， 计 划 在 分 页 Map 中 加 
入 cache 键 ， 当 cache 键 值 为 true 且 查询 的 Domain 类 配置 了 二 级 Cache， 则 执行 查询 时 使 
用 Query Cache。 

开源 的 好 处 就 在 于 ， 用 户 可 以 自己 动手 对 其 进行 修改 。 要 实现 上 面 提出 的 功能 ， 只 需 
要 解决 两 个 问题 : 第 一 ， 判 断 某 一 个 Domain 类 是 否 使 用 了 cache; 第 二 ， 判 断 分 页 Map 
中 是 否 包含 cache 键 ， 并 根据 它 的 值 ， 设 置 Query Cache。 

首先 ， 解 决 第 一 个 问题 。 通 过 org.codehaus.groovy.grails.orm.hibernate.cfg 包 中 的 
GrailsDomainBinder 类 ， 可 以 读 取 Domain 类 的 mapping 信息 。 


其 中 ，clazz 参数 是 具体 Domain 实例 的 class 属性 ， 返 回 值 的 Mapping 类 是 
org.codehaus.groovy.grails.orm.hibernate.cfg 包 下 面 的 一 个 Groovy 类 。Mapping 类 中 包含 了 
cache 属性 ， 类 型 为 CacheConfig。CacheConfig 类 和 Mapping 类 在 同一 个 包 中 ， 代 码 如 下 : 


显然 , 这 个 enabled 属性 正 是 判断 Domain 类 是 否 开 启 了 二 级 缓存 所 需要 的 。 如 果 使 用 
Groovy 进行 判断 ， 则 应 写成 如 下 样式 : 


如 果 用 Java 实现 ， 则 稍 显 复杂 : 


不 妨 在 GrailsHibemateUtil 类 中 添加 一 个 静态 方法 : 


至 此 ， 判 断 Domain 类 是 否 开启 了 二 级 缓存 的 问题 已 经 解决 了 。 接 下 来 ， 实 现在 分 页 
Map 中 添加 cache 键 ， 并 根据 该 键 值 配置 Query Cache。GrailsHibernateUtil 类 中 包含 了 名 
为 populateArgumentsForCriteria 的 方法 , 它 会 根据 Map 的 内 容 , 将 分 页 逻辑 、 排 序 等 约束 ， 
添加 到 Criteria 中 。 


可 以 重 载 populateArgumentsForCriteria 方法 ， 加 入 class 参数 以 判断 Domain 类 是 否 配 
置 了 cache， 再 根据 Map 中 cache 键 的 取 值 ， 为 Criteria 设置 cacheable 属性 即 可 。 


问题 还 没有 完 ， 由 于 并 没有 修改 原 有 的 populateArgumentsForCriteria 方法 ， 而 只 是 添 
加 了 新 的 方法 ， 因 此 ， 还 需要 修改 具体 的 查询 方法 (如 find*、findAll*、list 等 方法 )。 
GORM 中 封装 的 众多 数据 库 访问 方法 , 可 以 在 org.codehaus.groovy.grails.orm hibernate. 


metaclass 包 中 找到 。 每 个 非 抽 象 类 都 对 应 一 个 具体 的 方法 ， 如 FindAllByPersistentMethod 
类 实现 了 findAllBy* 方 法 ，ListPersistentMethod 类 实现 了 list 方法 ， 等 等 。 

这 些 类 重 写 (override) 了 AbstractStaticPersistentMethod 类 的 protected abstract Object 
dolInvokeInternal(Class，String，Object[]) 方 法 ， 并 且 在 该 方法 中 实现 具体 的 查询 过 程 。 以 
ListPersistentMethod 类 为 例 : 


其 中 “@” 所 在 的 行 调用 了 不 包含 class 参数 的 populateArgumentsForCriteria 方法 ， 需 
要 用 刚才 新 创建 的 方法 取代 它 : 


这 里 的 clazz 参数 ,恰好 是 Domain 类 的 class 属性 。 因 而 ,实现 了 为 list 方法 添加 配置 
Query Cache。 对 其 他 GORM 查询 方法 的 改造 ， 在 原理 上 和 list 方法 是 一 样 的 。 

修改 完成 后 ， 重 新 编译 Grails。 在 项 目 中 修改 配置 文件 grails-app\conf\Config.groovy 
以 开启 Hibernate 对 cache 的 日 志 ， 修 改 方式 为 : 


这 样 ， 就 可 以 测试 开启 Query Cache 的 效果 了 。 


19.4 ”本章 小 结 


本 章 对 Grails 的 部 分 源 代码 进行 了 简单 的 剖析 ， 通 过 对 源 代 码 的 阅读 和 修改 ， 读 者 可 
以 更 好 地 学 习 和 理解 Grails 技术 。 本 章 希 望 起 到 一 个 抛砖引玉 的 作用 ， 期 竺 聪明 的 读者 发 
掘 出 更 多 更 有 趣 的 秘密 。 


#2 Os 


本 书 介绍 的 Grails 基于 当前 最 新 的 稳定 版 本 ， 即 1.0.4 版 。 下 一 个 重要 的 release 版 本 
是 1.1， 有 很 多 明显 的 改进 和 增强 。 


20.1 GORM 的 新 特性 


20.1.1 更 多 的 GORM 事件 


在 1.1 版 中 ，GORM 增加 了 afterInsert、afterUpdate 和 afterDelete 这 3 个 事件 ， 从 而 得 
到 了 一 个 更 完整 的 事件 模型 。 各 个 事件 的 触发 时 机 如 表 20-1 所 示 。 


表 20-1 GORM 中 的 事件 


事件 触发 时 机 实例 
def beforeInsert = { 
插入 前 触发 //do something before insert 


} 
def beforeUpdate = { 

更 新 前 触发 //do something before update 
} 
def beforeDelete = { 

删除 前 触发 //do something before delete 
} 
def onLoad= { 

载 入 后 触发 /do something after loaded 
} 
def afterInsert ={ 

插入 后 触发 Vido something after insert 
} 
def afterUpdate = { 

更 新 后 触发 /do something after update 
} 
def afterDelete = { 

删除 后 触发 /do something after loaded 
} 


1 当前 的 Grails 1.1 还 处 于 Beta 2 测试 阶段 。 


20.1.2 ”映射 基本 类 型 的 集合 


GORM 现在 支持 使 用 关联 表 (join table) 对 基本 类 型 (如 String、Integer 等 ) 进行 映 
射 。 例 如 : 


则 此 时 数据 库 表 的 DDL 为 : 


显然 ，Grails 根据 Person 和 nickname 间 的 一 对 多 关系 ， 为 nickname 创建 了 person_ 
nicknames 表 ， 并 创建 了 外 键 约束 。 


20.1.3 ”对 Domain 的 只 读 访问 


Grails 1.1 新 增 了 read 方法 ， 用 于 实现 获取 只 读 Domain 类 实例 ， 例 如 : 


20.1.4 ”定义 默认 排序 字段 


第 7 章 中 ,设计 了 Cart 和 LineItem 两 个 Domain 类 用 于 描述 购物 车 。 访问 购物 车 中 内 
容 的 代码 如 下 : 


cartlineItems 这 样 的 写法 虽然 简单 却 有 一 定 的 不 足 ， 那 就 是 ， 无 法 指定 lineItems 的 排 
序 规则 。Grails 1.1 提供 了 定义 默认 排序 字段 的 方法 ， 可 以 弥补 这 个 不 足 。 


Grails 1.1 现在 可 以 在 类 一 级 或 者 关联 一 级 指定 默认 排序 字段 ， 下 面 的 代码 展示 了 如 何 
在 类 级 别 定义 默认 排序 字段 : 


此 时 ， 如 果 调 用 list 方法 对 LineItem 进行 查询 ， 则 返回 : 


但 此 时 调用 cartlineItems 仍然 没有 对 LineItem 进行 排序 查询 。 若 要 在 访问 cartlineItems 
时 进行 排序 ， 则 需要 在 关系 级 别 定义 默认 排序 字段 : 


则 此 时 生成 的 SQL 为 : 


值得 注意 的 是 ,排序 的 字段 需要 写 为 goods_ id 而 不 是 goods id, 这 可 能 是 Beta 版 的 bug。 
20.1.5 改进 的 findBy 


Grails 1.1 中 的 findBy 方法 ， 支 持 inList 查询 条 件 ， 支 持 Query Cache， 支 持 悲观 锁 。 


20.2 ”对 插件 系统 的 改进 


Grails 1.0.4 中 ， 需 要 为 每 个 应 用 单独 安装 插件 ， 到 了 Grails 1.1 中 ,可 以 一 次 性 为 所 有 
的 应 用 安装 插件 ， 即 全 局 插件 : 


20.3 ”数据 绑 定 


Grails 1.1 对 表单 提交 时 的 数据 绑 定 也 进行 了 改进 。 具体 表现 为 Domain 类 的 properties 
属性 ， 首 先 回忆 一 下 1.1 版 之 前 的 properties 属性 的 使 用 : 


上 面 的 写法 存在 一 定 的 风险 。 假 如 希望 提交 的 表单 不 包含 goods 的 全 部 属性 ， 则 理论 


上 提交 后 的 params 中 也 不 应 包含 goods 的 全 部 属性 。 然 而 ， 恶 意 的 用 户 可 以 伪造 提交 的 表 
单 内 容 ， 在 其 中 包含 一 些 本 不 希望 更 新 的 属性 ， 从 而 达到 恶意 更 新 的 目的 。 
Grails 1.1 中 ， 可 以 为 properties 指定 部 分 需要 更 新 的 属性 ， 例 如 : 


20.4 在 GSP 中 使 用 JSP 的 标签 


Grails 1.1 可 以 在 GSP 中 使 用 JSP 标签 ， 这 对 实现 历史 遗产 的 支持 ， 有 着 重大 的 意义 ， 
下 面 的 例子 展示 了 如 何在 GSP 中 调用 JSTL 的 formatNumber 标签 : 


不 仅 如 此 ， 在 GSP 中 ， 还 可 以 像 调用 普通 方法 那样 调用 JSP 的 标签 ， 例 如 : 


20.5 加 密 配置 文件 中 的 数据 库 密码 


DataSource 中 配置 了 数据 库 的 密码 。 在 1.1 版 之 前 ， 都 是 在 DataSource 中 使 用 明文 作 
为 密码 。 然 而 ， 使 用 明文 作 密码 ， 总 是 不 够 安全 的 。Grails 1.1 中 ， 可 以 通过 指定 Codec， 
实现 在 DataSource 配置 文件 中 使 用 密 文 作为 数据 库 的 密码 : 


其 中 的 passwordEncryptionCodec 属性 指定 了 用 于 对 密 文 密码 〈438uodf9s872398783r) 
进行 解密 的 类 。 其 原理 与 第 6 章 介 绍 的 Codec 类 是 一 样 的 。 


20.6 本章 小 结 


本 章 介绍 了 Grails 1.1 的 一 些 新 特性 ， 当 前 Grails 1.1 还 处 于 Beta2 的 状态 ， 部 分 新 功 
能 还 不 够 成 熟 。 但 从 现在 看 到 的 这 些 改进 , 能 看 到 G2One 小 组 对 Grails 所 付出 的 努力 ， 也 
更 有 理由 相信 Grails 1.1 的 明天 会 更 好 ! 
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索 引 


本 索引 约定 如 下 : 词 条 按 英文 字母 顺序 排列 〈 如 果 是 中 文 ， 则 以 中 文 对 应 的 汉语 拼音 
为 序 ) ; 索引 中 列 出 了 部 分 词 条 的 中 英文 对 照 ， 但 对 一 些 约定 俗 成 的 专用 英文 词 条 或 缩写 
仅 列 出 英文 词 条 ， 词 条 所 在 页 码 指 该 词 条 在 文中 首次 出 现 〈 或 特别 定义 的 地 方 ) 的 页 码 。 


